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",
"key": "premium_widget.standard_pricebook",
"product": {
"id": "660e8400-e29b-41d4-a716-446655440001",
"name": "Premium Widget",
"product_parent_id": "770e8400-e29b-41d4-a716-446655440002"
},
"pricebook": {
"id": "880e8400-e29b-41d4-a716-446655440003",
"name": "Standard Pricebook",
"api_name": "standard_pricebook",
"type": "fixed"
},
"currency": {
"id": "990e8400-e29b-41d4-a716-446655440004",
"name": "Euro",
"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",
"name": "VAT 20%",
"api_name": "vat_20",
"rate": 20.0,
"amount": null,
"is_percentage": true
},
"billing_frequency": 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",
"key": "premium_widget.standard_pricebook",
"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": {
"id": "990e8400-e29b-41d4-a716-446655440004",
"name": "Euro",
"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",
"key": "premium_widget.standard_pricebook",
"product": {
"id": "660e8400-e29b-41d4-a716-446655440001",
"name": "Premium Widget",
"product_parent_id": "770e8400-e29b-41d4-a716-446655440002"
},
"pricebook": {
"id": "880e8400-e29b-41d4-a716-446655440003",
"name": "Standard Pricebook",
"api_name": "standard_pricebook",
"type": "fixed"
},
"currency": {
"id": "990e8400-e29b-41d4-a716-446655440004",
"name": "Euro",
"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",
"name": "VAT 20%",
"api_name": "vat_20",
"rate": 20.0,
"amount": null,
"is_percentage": true
},
"billing_frequency": 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",
"key": "premium_widget.standard_pricebook",
"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": {
"id": "990e8400-e29b-41d4-a716-446655440004",
"name": "Euro",
"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
string | null
Semantic price key, computed (not stored):
<product_api_name>.<pricebook_api_name> for a one-off price, followed by .<unit>.<period> for a recurring one (e.g. licence_pro.standard_eur.month.1). Paste it as-is in the id column of the CSV price import. null without a pricebook.object
object
object
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
object | null
object | null
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",
"key": "premium_widget.standard_pricebook",
"product": {
"id": "660e8400-e29b-41d4-a716-446655440001",
"name": "Premium Widget",
"product_parent_id": "770e8400-e29b-41d4-a716-446655440002"
},
"pricebook": {
"id": "880e8400-e29b-41d4-a716-446655440003",
"name": "Standard Pricebook",
"api_name": "standard_pricebook",
"type": "fixed"
},
"currency": {
"id": "990e8400-e29b-41d4-a716-446655440004",
"name": "Euro",
"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",
"name": "VAT 20%",
"api_name": "vat_20",
"rate": 20.0,
"amount": null,
"is_percentage": true
},
"billing_frequency": 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",
"key": "premium_widget.standard_pricebook",
"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": {
"id": "990e8400-e29b-41d4-a716-446655440004",
"name": "Euro",
"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()
Last modified on October 28, 2026
Was this page helpful?

