curl -X GET https://qwoty.app/api/prices/550e8400-e29b-41d4-a716-446655440000 \
-H "Authorization: Bearer qwoty_your_token"
const response = await fetch(
'https://qwoty.app/api/prices/550e8400-e29b-41d4-a716-446655440000',
{
headers: {
Authorization: 'Bearer qwoty_your_token',
},
},
)
const { success, data } = await response.json()
import requests
response = requests.get(
'https://qwoty.app/api/prices/550e8400-e29b-41d4-a716-446655440000',
headers={'Authorization': 'Bearer qwoty_your_token'},
)
data = response.json()
{
"success": true,
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"product_id": "660e8400-e29b-41d4-a716-446655440001",
"product_variant_name": "Premium Widget",
"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"
}
}
{
"success": true,
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"pricing_model": "volume",
"amount": null,
"volume_tiers": [
{
"first_unit": 1,
"last_unit": 100,
"amount_per_unit": 10.0,
"flat_fee": 0
},
{
"first_unit": 101,
"last_unit": 500,
"amount_per_unit": 8.5,
"flat_fee": 0
},
{
"first_unit": 501,
"last_unit": null,
"amount_per_unit": 7.0,
"flat_fee": 0
}
],
"is_volume_grid_displayed": true,
"currency_api_name": "EUR"
}
}
{
"success": false,
"error": "Price not found"
}
Prices
Get Price
Retrieve a specific price by ID
GET
/
api
/
prices
/
{id}
curl -X GET https://qwoty.app/api/prices/550e8400-e29b-41d4-a716-446655440000 \
-H "Authorization: Bearer qwoty_your_token"
const response = await fetch(
'https://qwoty.app/api/prices/550e8400-e29b-41d4-a716-446655440000',
{
headers: {
Authorization: 'Bearer qwoty_your_token',
},
},
)
const { success, data } = await response.json()
import requests
response = requests.get(
'https://qwoty.app/api/prices/550e8400-e29b-41d4-a716-446655440000',
headers={'Authorization': 'Bearer qwoty_your_token'},
)
data = response.json()
{
"success": true,
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"product_id": "660e8400-e29b-41d4-a716-446655440001",
"product_variant_name": "Premium Widget",
"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"
}
}
{
"success": true,
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"pricing_model": "volume",
"amount": null,
"volume_tiers": [
{
"first_unit": 1,
"last_unit": 100,
"amount_per_unit": 10.0,
"flat_fee": 0
},
{
"first_unit": 101,
"last_unit": 500,
"amount_per_unit": 8.5,
"flat_fee": 0
},
{
"first_unit": 501,
"last_unit": null,
"amount_per_unit": 7.0,
"flat_fee": 0
}
],
"is_volume_grid_displayed": true,
"currency_api_name": "EUR"
}
}
{
"success": false,
"error": "Price not found"
}
Returns detailed information about a specific price, including all pricing configuration and enriched data.
Authentication
string
required
Bearer token for authentication
Path Parameters
uuid
required
The unique identifier of the price
Response
boolean
Indicates if the request was successful
object
The complete price object with all fields and enriched data
Show Full Price Details
Show Full Price Details
uuid
Unique identifier for the price
uuid
ID of the product this price applies to
string
Name of the product variant (enriched)
uuid
ID of the pricebook
string
Name of the pricebook (enriched)
string
Type:
fixed or dynamic (enriched)uuid
ID of the currency
string
Currency name (enriched)
string
Currency code, e.g.,
EUR, USD (enriched)string
One of:
flat, volume, graduated, percent, cost_based, nonenumber | null
Fixed price amount (for flat model)
array | null
boolean
Show volume tiers to customers
array | null
Graduated pricing tiers (same structure as volume_tiers)
boolean
Show graduated tiers to customers
number | null
Percentage value (0-100) for percent-based pricing
string | null
Percentage scope:
all, product_type, or productnumber | null
Multiplier applied to cost for cost-based pricing
number | null
Base cost price
number | null
Minimum acceptable price
boolean
Whether this is a one-time setup fee
boolean
Whether this uses pay-as-you-go billing
uuid | null
ID of default sales tax
string | null
Tax name (enriched)
number | null
Tax rate percentage (enriched)
number | null
Fixed tax amount (enriched)
boolean | null
Whether tax is percentage-based (enriched)
uuid | null
ID of billing frequency for recurring prices
number | null
Number of billing periods (enriched)
string | null
Billing period unit:
day, week, month, year (enriched)string | null
forever or fixed_periodnumber | null
Number of periods for fixed engagements
uuid | null
Parent price ID for dynamic pricebooks
object
uuid
Workspace this price belongs to
timestamp
Creation timestamp
timestamp
Last update timestamp
{
"success": true,
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"product_id": "660e8400-e29b-41d4-a716-446655440001",
"product_variant_name": "Premium Widget",
"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"
}
}
{
"success": true,
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"pricing_model": "volume",
"amount": null,
"volume_tiers": [
{
"first_unit": 1,
"last_unit": 100,
"amount_per_unit": 10.0,
"flat_fee": 0
},
{
"first_unit": 101,
"last_unit": 500,
"amount_per_unit": 8.5,
"flat_fee": 0
},
{
"first_unit": 501,
"last_unit": null,
"amount_per_unit": 7.0,
"flat_fee": 0
}
],
"is_volume_grid_displayed": true,
"currency_api_name": "EUR"
}
}
{
"success": false,
"error": "Price not found"
}
curl -X GET https://qwoty.app/api/prices/550e8400-e29b-41d4-a716-446655440000 \
-H "Authorization: Bearer qwoty_your_token"
const response = await fetch(
'https://qwoty.app/api/prices/550e8400-e29b-41d4-a716-446655440000',
{
headers: {
Authorization: 'Bearer qwoty_your_token',
},
},
)
const { success, data } = await response.json()
import requests
response = requests.get(
'https://qwoty.app/api/prices/550e8400-e29b-41d4-a716-446655440000',
headers={'Authorization': 'Bearer qwoty_your_token'},
)
data = response.json()
Was this page helpful?
⌘I

