Multi-Tenant Mobility Platform โ€” Backend API Explorer (OpenAPI 3.1)

Database: app-main / app_core / main-user ยท Alle endpoints voorzien van Correlation-ID, Rate-Limiting & RLS
๐Ÿ“„ OpenAPI 3.1 JSON  |  ๐Ÿ“Š Live Diagnostics  |  ๐Ÿ“ˆ Prometheus Metrics
MethodEndpointModuleFunctieBeveiliging & Garanties
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