GET/v1/billing/prices

Your prices

The effective price rules for the organisation today: the list prices with the pricing agreement applied, the VAT treatment and the current agreement.

Scope billing.read

Returns

4 fields of the 200 answer

priceListobject or nullrequired

5 fields

idstringrequired

namestringrequired

currencystringrequired

effectiveFromdaterequired

effectiveTodate or nullrequired

agreementobject or nullrequired

5 fields

idstringrequired

namestringrequired

effectiveFromdaterequired

effectiveTodate or nullrequired

discountPercentnumber or nullrequired

vatobjectrequired

2 fields

treatmentenumrequired

NL_STANDARDEU_REVERSE_CHARGENON_EU

rateintegerrequired

rulesarray of objectsrequired

8 fields

productIdstringrequired

productNamestringrequired

finishstring or nullrequired

destinationstring or nullrequired

minQuantityintegerrequired

listUnitPriceCentsintegerrequired

unitPriceCentsintegerrequired

sourceenumrequired

listagreement

Responses

200Success

401Authentication required or API key invalid

403Permission or scope missing, organisation suspended

429Rate limited for this API key and class; wait Retry-After seconds

otherError (RFC 9457 problem details)

{ "priceList": { "id": "pl_01J9Y2K8QF4T6W8Z0B2D4F6H8K", "name": "Welcome card", "currency": "EUR", "effectiveFrom": "2026-11-02", "effectiveTo": "2026-11-02" }, "agreement": { "id": "obj_01J9Y2K8QF4T6W8Z0B2D4F6H8K", "name": "Welcome card", "effectiveFrom": "2026-11-02", "effectiveTo": "2026-11-02", "discountPercent": 3 }, "vat": { "treatment": "NL_STANDARD", "rate": 1 }, "rules": [ { "productId": "prd_01J9Y2K8QF4T6W8Z0B2D4F6H8K", "productName": "Example", "finish": "silk", "destination": "Example", "minQuantity": 1, "listUnitPriceCents": 1250, "unitPriceCents": 1250, "source": "list" } ] }