Pricing API

Manage pricing rules, cancellation policies, and preview calculated prices. All amounts are in cents (EUR).

Endpoints

GET

/tenants/{tenantId}/pricing-rules

List all pricing rules

POST

/tenants/{tenantId}/pricing-rules

Create a pricing rule

GET

/tenants/{tenantId}/cancellation-policies

List cancellation policies

POST

/api/pricing/preview

Preview calculated price for a booking

Price Preview

Calculate the price for a potential booking without creating it. Applies all active pricing rules (time-based, weekday, etc.).

Requestbash

curl -X POST \
  "https://your-domain.booqr.nl/api/pricing/preview" \
  -H "Authorization: Bearer booqr_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "objectId": "object-uuid",
    "startTime": "2026-02-18T10:00:00Z",
    "endTime": "2026-02-18T12:00:00Z"
  }'

Response 200json

{
  "basePrice": 5000,
  "adjustments": [
    { "rule": "Weekend surcharge", "amount": 500 }
  ],
  "totalPrice": 5500,
  "currency": "EUR",
  "breakdown": "2 hours × €25.00/hr + €5.00 weekend surcharge"
}

Pricing Rule Types

Type	Description	Example
`time_based`	Different price by time of day	Peak hours (17:00-21:00): +€5/hr
`day_based`	Different price by day of week	Weekend surcharge: +10%
`duration_based`	Discount for longer bookings	Book 3+ hours: -15%
`early_bird`	Discount for advance bookings	Book 7+ days ahead: -10%