Get Price - Qwoty

curl -X GET https://qwoty.app/api/prices/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer qwoty_your_token"

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "product_variant_id": "660e8400-e29b-41d4-a716-446655440001",
    "product_variant_name": "Premium Widget",
    "product_id": "770e8400-e29b-41d4-a716-446655440002",
    "pricebook_id": "880e8400-e29b-41d4-a716-446655440003",
    "pricebook_name": "Standard Pricebook",
    "pricebook_type": "fixed",
    "currency_id": "990e8400-e29b-41d4-a716-446655440004",
    "currency_name": "Euro",
    "currency_api_name": "EUR",
    "pricing_model": "flat",
    "amount": 99.99,
    "volume_tiers": null,
    "is_volume_grid_displayed": false,
    "graduated_tiers": null,
    "is_graduated_grid_displayed": false,
    "percent": null,
    "price_percentage_type": null,
    "cost_multiplier": null,
    "cost": 50.0,
    "floor_price": 80.0,
    "is_setup": false,
    "is_pay_as_you_go": false,
    "default_tax_id": "aa0e8400-e29b-41d4-a716-446655440005",
    "default_tax_name": "VAT 20%",
    "default_tax_rate": 20.0,
    "default_tax_amount": null,
    "default_tax_is_percentage": true,
    "billing_frequency_id": null,
    "billing_frequency_period": null,
    "billing_frequency_unit": null,
    "engagement_type": null,
    "period_duration": null,
    "parent_price_id": null,
    "identifiers": {
      "crm": "crm_price_001",
      "erp": "erp_price_001",
      "accounting": "acc_price_001"
    },
    "workspace_id": "cc0e8400-e29b-41d4-a716-446655440007",
    "created_at": "2024-12-21T10:30:00Z",
    "updated_at": "2024-12-21T14:45:00Z"
  }
}

GET

api

prices

{id}

curl -X GET https://qwoty.app/api/prices/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer qwoty_your_token"

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "product_variant_id": "660e8400-e29b-41d4-a716-446655440001",
    "product_variant_name": "Premium Widget",
    "product_id": "770e8400-e29b-41d4-a716-446655440002",
    "pricebook_id": "880e8400-e29b-41d4-a716-446655440003",
    "pricebook_name": "Standard Pricebook",
    "pricebook_type": "fixed",
    "currency_id": "990e8400-e29b-41d4-a716-446655440004",
    "currency_name": "Euro",
    "currency_api_name": "EUR",
    "pricing_model": "flat",
    "amount": 99.99,
    "volume_tiers": null,
    "is_volume_grid_displayed": false,
    "graduated_tiers": null,
    "is_graduated_grid_displayed": false,
    "percent": null,
    "price_percentage_type": null,
    "cost_multiplier": null,
    "cost": 50.0,
    "floor_price": 80.0,
    "is_setup": false,
    "is_pay_as_you_go": false,
    "default_tax_id": "aa0e8400-e29b-41d4-a716-446655440005",
    "default_tax_name": "VAT 20%",
    "default_tax_rate": 20.0,
    "default_tax_amount": null,
    "default_tax_is_percentage": true,
    "billing_frequency_id": null,
    "billing_frequency_period": null,
    "billing_frequency_unit": null,
    "engagement_type": null,
    "period_duration": null,
    "parent_price_id": null,
    "identifiers": {
      "crm": "crm_price_001",
      "erp": "erp_price_001",
      "accounting": "acc_price_001"
    },
    "workspace_id": "cc0e8400-e29b-41d4-a716-446655440007",
    "created_at": "2024-12-21T10:30:00Z",
    "updated_at": "2024-12-21T14:45:00Z"
  }
}

Returns detailed information about a specific price, including all pricing configuration and enriched data.

Authentication

Authorization

string

required

Bearer token for authentication

Path Parameters

uuid

required

The unique identifier of the price

Response

success

boolean

Indicates if the request was successful

data

object

The complete price object with all fields and enriched data

Show Full Price Details

uuid

Unique identifier for the price

product_variant_id

uuid

ID of the product variant

product_variant_name

string

Name of the product variant (enriched)

product_id

uuid

ID of the parent product (enriched)

pricebook_id

uuid

ID of the pricebook

pricebook_name

string

Name of the pricebook (enriched)

pricebook_type

string

Type: fixed or dynamic (enriched)

currency_id

uuid

ID of the currency

currency_name

string

Currency name (enriched)

currency_api_name

string

Currency code, e.g., EUR, USD (enriched)

pricing_model

string

One of: flat, volume, graduated, percent, cost_based, none

amount

number | null

Fixed price amount (for flat model)

volume_tiers

array | null

Volume pricing tiers

Show Tier Structure

first_unit

number

Starting unit for this tier

last_unit

number | null

Ending unit (null for unlimited)

amount_per_unit

number

Price per unit in this tier

flat_fee

number

Fixed fee for this tier

is_volume_grid_displayed

boolean

Show volume tiers to customers

graduated_tiers

array | null

Graduated pricing tiers (same structure as volume_tiers)

is_graduated_grid_displayed

boolean

Show graduated tiers to customers

percent

number | null

Percentage value (0-100) for percent-based pricing

price_percentage_type

string | null

Percentage scope: all, product_type, or product

cost_multiplier

number | null

Multiplier applied to cost for cost-based pricing

cost

number | null

Base cost price

floor_price

number | null

Minimum acceptable price

is_setup

boolean

Whether this is a one-time setup fee

is_pay_as_you_go

boolean

Whether this uses pay-as-you-go billing

default_tax_id

uuid | null

ID of default sales tax

default_tax_name

string | null

Tax name (enriched)

default_tax_rate

number | null

Tax rate percentage (enriched)

default_tax_amount

number | null

Fixed tax amount (enriched)

default_tax_is_percentage

boolean | null

Whether tax is percentage-based (enriched)

billing_frequency_id

uuid | null

ID of billing frequency for recurring prices

billing_frequency_period

number | null

Number of billing periods (enriched)

billing_frequency_unit

string | null

Billing period unit: day, week, month, year (enriched)

engagement_type

string | null

forever or fixed_period

period_duration

number | null

Number of periods for fixed engagements

parent_price_id

uuid | null

Parent price ID for dynamic pricebooks

identifiers

object

External system identifiers

Show identifiers properties

crm

string | null

External CRM system identifier

erp

string | null

External ERP system identifier

accounting

string | null

External accounting system identifier

workspace_id

uuid

Workspace this price belongs to

created_at

timestamp

Creation timestamp

updated_at

timestamp

Last update timestamp

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "product_variant_id": "660e8400-e29b-41d4-a716-446655440001",
    "product_variant_name": "Premium Widget",
    "product_id": "770e8400-e29b-41d4-a716-446655440002",
    "pricebook_id": "880e8400-e29b-41d4-a716-446655440003",
    "pricebook_name": "Standard Pricebook",
    "pricebook_type": "fixed",
    "currency_id": "990e8400-e29b-41d4-a716-446655440004",
    "currency_name": "Euro",
    "currency_api_name": "EUR",
    "pricing_model": "flat",
    "amount": 99.99,
    "volume_tiers": null,
    "is_volume_grid_displayed": false,
    "graduated_tiers": null,
    "is_graduated_grid_displayed": false,
    "percent": null,
    "price_percentage_type": null,
    "cost_multiplier": null,
    "cost": 50.0,
    "floor_price": 80.0,
    "is_setup": false,
    "is_pay_as_you_go": false,
    "default_tax_id": "aa0e8400-e29b-41d4-a716-446655440005",
    "default_tax_name": "VAT 20%",
    "default_tax_rate": 20.0,
    "default_tax_amount": null,
    "default_tax_is_percentage": true,
    "billing_frequency_id": null,
    "billing_frequency_period": null,
    "billing_frequency_unit": null,
    "engagement_type": null,
    "period_duration": null,
    "parent_price_id": null,
    "identifiers": {
      "crm": "crm_price_001",
      "erp": "erp_price_001",
      "accounting": "acc_price_001"
    },
    "workspace_id": "cc0e8400-e29b-41d4-a716-446655440007",
    "created_at": "2024-12-21T10:30:00Z",
    "updated_at": "2024-12-21T14:45:00Z"
  }
}

curl -X GET https://qwoty.app/api/prices/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer qwoty_your_token"

List All Prices

Update Price

​Authentication

​Path Parameters

​Response

Authentication

Path Parameters

Response