| GET |
/api/v1/health |
system |
Liveness, readiness & PostgreSQL (app-main / app_core / main-user) contract check |
standard-api |
| GET |
/api/v1/config/bootstrap |
system |
Dynamic white-label branding, colors, locales, EU operating countries & pricing policy per tenant |
standard-api |
| GET |
/api/v1/system/diagnostics |
system |
Real-time endpoint latency metrics, tenant request counters, and transactional outbox event log |
standard-api |
| GET |
/api/v1/metrics |
system |
Prometheus exposition format metrics for Grafana / Loki observability stack |
standard-api |
| POST |
/api/v1/auth/otp/request |
identity |
Request SMS OTP login challenge (strictly rate-limited per IP and tenant) |
strict-auth ยท ๐ Idempotent |
| POST |
/api/v1/auth/otp/verify |
identity |
Verify OTP and issue HMAC-SHA256 tenant-bound JWT access token + rotating refresh token |
strict-auth |
| GET |
/api/v1/users/{userId}/account |
users |
Get customer personal profile, Business B2B invoice profile, saved places & emergency contact |
standard-api |
| PUT |
/api/v1/users/{userId}/account |
users |
Update customer personal & Business B2B fiscal profile |
standard-api ยท ๐ Idempotent |
| GET |
/api/v1/drivers/{driverId}/account |
drivers |
Get driver profile, vehicle, statutory carrier fiscal profile (KvK/BTW/KOR/IBAN), navigation prefs & KIWA docs |
standard-api |
| PUT |
/api/v1/drivers/{driverId}/account |
drivers |
Update driver statutory carrier profile, tax regime (standard_vat / kor_exempt) & preferred navigation app |
standard-api ยท ๐ Idempotent |
| GET |
/api/v1/drivers/{driverId}/tariff |
drivers |
Get driver custom ride price factor (%) and tariff version |
standard-api |
| PUT |
/api/v1/drivers/{driverId}/tariff |
drivers |
Set driver custom price factor (%) within tenant bounds and increment tariff version |
standard-api ยท ๐ Idempotent |
| GET |
/api/v1/geo/autocomplete |
geo |
PDOK / Photon address, postcode & POI autocomplete within active tenant country |
standard-api |
| POST |
/api/v1/geo/validate-address |
geo |
Validate address clarity (Postcode+HouseNo, missing house number, ambiguous city, or EU domestic-only geofence) |
standard-api |
| POST |
/api/v1/rides/compose-preview |
rides |
Calculate multi-stop OSRM route distance/duration and upfront prices across all 4 vehicle classes |
standard-api |
| POST |
/api/v1/rides/request |
rides |
Create new ride request (supports Idempotency-Key header to prevent double booking) |
standard-api ยท ๐ Idempotent |
| POST |
/api/v1/rides/{rideId}/accept |
rides |
Driver accepts ride: locks agreed driver tariff, shares driver photo/vehicle card, generates 4-digit PIN & phase-1 Waze/Google deep-links |
standard-api ยท ๐ Idempotent |
| POST |
/api/v1/rides/{rideId}/verify-pin |
rides |
Verify shared 4-digit customer security PIN at pickup and auto-switch navigation deep-links to final destination |
standard-api ยท ๐ Idempotent |
| POST |
/api/v1/rides/{rideId}/complete |
rides |
Complete ride, book double-entry ledger, and issue statutory Customer (B2B/B2C) & Driver Commission (Art. 35a / ICP 3b) invoices |
standard-api ยท ๐ Idempotent |
| GET |
/api/v1/invoices/{invoiceId}/pdf |
payments |
Download native binary PDF 1.4 statutory invoice (Customer Ride Invoice, Driver Commission Statement, or Credit Note) |
standard-api |
| POST |
/api/v1/invoices/{invoiceId}/credit |
payments |
Issue immutable statutory Credit Note (CRED-...) reversing an invoice (Art. 35a Wet OB) |
standard-api ยท ๐ Idempotent |
| GET |
/api/v1/accounting/driver/{driverId} |
payments |
Driver bookkeeping summary with official Belastingdienst VAT return boxes (1b, 1e, 5b, 5g) and EU DAC7 report row |
standard-api |
| GET |
/api/v1/accounting/customer/{userId} |
payments |
Customer bookkeeping summary strictly separated into Business (B2B with Rubriek 5b VAT recovery) and Private (B2C) |
standard-api |
| POST |
/api/v1/rides/wait-and-cancel-policy |
rides |
Calculate smart wait-time (3m street / 10m flight grace), late-cancellation en-route fee, or GPS-verified No-Show compensation |
standard-api |
| GET |
/api/v1/compliance/ilt-cdt-pass/{driverId} |
drivers |
Dutch ILT / CDT (Centrale Database Taxivervoer) & ATBv work/rest-time digital roadside inspection pass with SHA-256 signature |
standard-api |
| GET |
/api/v1/accounting/corporate-monthly |
payments |
B2B Corporate Account (`Op Rekening`) monthly consolidated invoice specification & Hotel/Hospital Concierge rides |
standard-api |
| GET |
/api/v1/accounting/corporate-monthly/pdf |
payments |
Download native binary PDF 1.4 Monthly Consolidated B2B Invoice (`VERZ-...`) with itemized cost centers & Rubriek 5b VAT |
standard-api |
| POST |
/api/v1/support/tickets |
support |
Create Privacy-First Lost & Found (`Gevonden Voorwerpen`) with AVG/GDPR Masked Phone Relay or TTO/TX-Keur dispute ticket |
standard-api ยท ๐ Idempotent |
| POST |
/api/v1/webhooks/stripe |
payments |
Cryptographic Stripe Connect Webhook receiver (`Stripe-Signature` HMAC-SHA256) with automatic Credit Note (`CRED-...`) on refund |
standard-api ยท ๐ Idempotent |
| GET |
/api/v1/events/stream |
notifications |
Real-time Server-Sent Events (SSE) push stream for Driver & Customer apps and Dispatch consoles |
standard-api |