List All Prices

curl -X GET "https://qwoty.app/api/prices?limit=50&offset=0" \
  -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"
    }
  ],
  "total": 1,
  "limit": 100,
  "offset": 0
}

GET

api

prices

curl -X GET "https://qwoty.app/api/prices?limit=50&offset=0" \
  -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"
    }
  ],
  "total": 1,
  "limit": 100,
  "offset": 0
}

Returns a list of all prices in your workspace with enriched data including product variant, pricebook, currency, and tax information.

Authentication

Authorization

string

required

Bearer token for authentication

Query Parameters

limit

number

default:"100"

Maximum number of prices to return. Min: 1, Max: 1000.

offset

number

default:"0"

Number of prices to skip (for pagination).

Response

success

boolean

Indicates if the request was successful

data

array

Array of price objects with enriched data

Show Price Object

uuid

Unique identifier for the price

product_variant_id

uuid

ID of the product variant this price applies to

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 containing this price

pricebook_name

string

Name of the pricebook (enriched)

pricebook_type

string

Type of pricebook: fixed or dynamic (enriched)

currency_id

uuid

ID of the currency for this price

currency_name

string

Name of the currency (enriched)

currency_api_name

string

API name/code of the currency, e.g., EUR, USD (enriched)

pricing_model

string

Pricing model: flat, volume, graduated, percent, cost_based, or none

amount

number | null

Fixed amount for flat pricing model

volume_tiers

array | null

Array of volume tier objects for volume pricing

is_volume_grid_displayed

boolean

Whether to display volume tiers to customers

graduated_tiers

array | null

Array of graduated tier objects for graduated pricing

is_graduated_grid_displayed

boolean

Whether to display graduated tiers to customers

percent

number | null

Percentage value (0-100) for percent pricing

price_percentage_type

string | null

Scope of percentage pricing: all, product_type, or product

cost_multiplier

number | null

Multiplier for cost-based pricing

cost

number | null

Cost price

floor_price

number | null

Minimum price threshold

is_setup

boolean

Whether this is a setup or one-time fee

is_pay_as_you_go

boolean

Whether this uses pay-as-you-go billing

default_tax_id

uuid | null

ID of the default sales tax

default_tax_name

string | null

Name of the default tax (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 the billing frequency for recurring prices

billing_frequency_period

number | null

Number of periods (enriched)

billing_frequency_unit

string | null

Unit of period: day, week, month, or year (enriched)

engagement_type

string | null

Type of engagement: forever or fixed_period

period_duration

number | null

Duration in periods for fixed engagements

parent_price_id

uuid | null

ID of parent price 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

created_at

timestamp

Timestamp of price creation

updated_at

timestamp

Timestamp of last update

workspace_id

uuid

Workspace this price belongs to

total

number

Total number of prices in the workspace

limit

number

Number of items returned per page

offset

number

Number of items skipped

{
  "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"
    }
  ],
  "total": 1,
  "limit": 100,
  "offset": 0
}

curl -X GET "https://qwoty.app/api/prices?limit=50&offset=0" \
  -H "Authorization: Bearer qwoty_your_token"

Update Product

Get Price

​Authentication

​Query Parameters

​Response

Authentication

Query Parameters

Response