Skip to content
Go

Pricing System

Taxi & Private Hire › Products › Pricing › Pricing System

Generally available

Architectural overview of the pricing pipeline: how tariffs are selected (decision tree), how tariff bands enforce stepped rates, how modifiers add conditional adjustments, how discount models (RIDE_SHARE / SINGLE_PRICED) handle shared trips, how chargeable capabilities turn into line items, how tax categories tag everything. Per-feature pages (pricing.tariffs, pricing.tariff-bands, pricing.pricing-modifiers, pricing.ride-share-discounts, pricing.single-priced-discounts, pricing.chargeable-capabilities, pricing.tax-categories) drill into each piece.

Example request

POST /client/{clientId}/tariff/{tariffId}/tariffband

See the API reference for the full request and response schema.

Endpoints

MethodPath
POST /client/{clientId}/modifierinstruction/{instructionId}/tariffband/{tariffbandId}
POST /client/{clientId}/tariff/{tariffId}/modifier/{modifierId}/modifierinstruction
DELETE /client/{clientId}/tariff/{tariffId}/modifier/{modifierId}/modifierinstruction/{instructionId}
GET /client/{clientId}/tariff/{tariffId}/modifier/{modifierId}/tariffband
GET /client/{clientId}/tariff/{tariffId}/modifier/{modifierId}/modifierinstruction
DELETE /client/{clientId}/modifierinstruction/{instructionId}/tariffband/{tariffbandId}
POST /client/{clientId}/tariff/{tariffId}/modifier/{modifierId}/modifierinstruction/{instructionId}
POST /client/{clientId}/tariff/{tariffId}/vehicletype/{vehicleTypeId}
DELETE /client/{clientId}/tariff/{tariffId}/vehicletype/{vehicleTypeId}
POST /client/{clientId}/tariff/{tariffId}/tariffband · primary
DELETE /client/{clientId}/tariff/{tariffId}/tariffband/{tariffbandId}
GET /client/{clientId}/tariff/{tariffId}/tariffband
GET /client/{clientId}/tariff/{tariffId}/tariffband/{tariffbandId}
POST /client/{clientId}/tariff/{tariffId}/tariffband/{tariffbandId}

Full request/response schemas and an interactive explorer will live in the API reference (coming soon).

Use cases

Operator flows that exercise this feature.

Link a tariff to a vehicle type

config risk: low

Apply a tariff to a specific vehicle type (vehicle-class pricing).

  1. POST /client/{clientId}/tariff/{tariffId}/vehicletype/{vehicleTypeId}
Create a tariff

config risk: medium

Create a tariff and add its first distance/time band.

  1. POST /client/{clientId}/tariff
  2. POST /client/{clientId}/tariff/{tariffId}/tariffband