Overview
Every endpoint below is versioned under /v1/, returns JSON, and requires a subscription key. See Authentication for how to send it and which endpoints additionally require calculation access.
Base URL
| Environment | Base URL |
|---|---|
| Acceptance / sandbox | https://ototo-acc.azure-api.net/v1/ |
| Production | https://api.ototo.be/v1/ |
Endpoints
Car Details
| Method | Route | Description |
|---|---|---|
| GET | /CarDetails/{carDetailId} | Retrieve a car detail by ID |
| POST | /CarDetails | Create a new car detail |
| PUT | /CarDetails/{carDetailId} | Upsert (create or update) a car detail |
Calculation
| Method | Route | Description |
|---|---|---|
| POST | /Calculate | Calculate taxation and cost details for one vehicle and profile |
| GET | /GetTaxMatrix | RoadTax & YearlyTax matrix across every profile and region for one vehicle |
→ Calculate reference · Tax Matrix reference
GetTaxMatrix is the newest endpoint on this list. If /GetTaxMatrix doesn't resolve on your gateway, confirm the exact routed path with your Ototo contact — it may still be reachable at the underlying function route /api/GetTaxMatrix.
Sharing
| Method | Route | Description |
|---|---|---|
| GET | /PublicLink | Get a public, shareable URL for an existing car detail |
| POST | /Qr | Generate a QR code image pointing at a car detail |
→ Public Link reference · QR Code reference
OpenAPI
The full API is also available as an OpenAPI 3.0 document — import it into Postman, Insomnia, or Azure API Management, or browse it interactively in the API Explorer.
Versioning
The current version is v1, reflected in the base URL. Production is stable: a change that isn't backwards compatible ships as a new version rather than altering v1 in place. Acceptance may evolve ahead of production as new functionality is developed — you'll be notified of impacting changes.
Errors
All endpoints return 401 for authentication problems — see Authentication. Beyond that, each endpoint's own page documents its specific 400/404 conditions and response shape.
Related
Changes to calculation rules (tax legislation updates, etc.) are announced via webhooks so you know when to recalculate and invalidate cached results.