Integrations

Public API & webhooks

A REST surface for corporate travel portals, ERPs and data warehouses, with signed webhooks for booking status, invoicing, payment and settlement events. Demo keys are read-only display values.

REST endpoints

https://project--1c2ca2fb-668c-4514-b7d1-40d84cebaa5b.lovable.app

Method	Path	Summary	Scope
GET	/api/public/v1/bookings	List bookings filtered by market, status and date range	bookings.read
GET	/api/public/v1/bookings/{ref}	Retrieve a single booking with allocation and flight watch	bookings.read
POST	/api/public/v1/bookings	Create a booking from a quote reference	bookings.write
POST	/api/public/v1/bookings/{ref}/cancel	Cancel a booking and trigger the cancellation webhook	bookings.write
GET	/api/public/v1/invoices	List invoices and credit notes with tax buckets	invoices.read
GET	/api/public/v1/payments	List payments with 3DS2 authentication outcome	payments.read
GET	/api/public/v1/settlements	List chauffeur settlements for a period	payments.read
GET	/api/public/v1/fleet	List fleet units with compliance and dispatch state	fleet.read
GET	/api/public/track/{ref}	Live tracking stream for a booking reference	tracking.read

curl "https://project--1c2ca2fb-668c-4514-b7d1-40d84cebaa5b.lovable.app/api/public/v1/bookings?market=UK&status=allocated" \
  -H "Authorization: Bearer mrd_demo_9f21..." \
  -H "Accept: application/json"

API keys & scopes

Keys are scoped least-privilege and rate limited per integration. Revoking a key takes effect immediately.

Corporate travel portal (Barrington)

mrd_demo_9f21••••••••••••4a70

active

bookings.readbookings.writeinvoices.readtracking.read

Created 12 Feb 2026 · last used 02 Jul 2026 08:41 · 600 req / min

Finance data warehouse

mrd_demo_31bc••••••••••••8e12

active

invoices.readpayments.read

Created 03 Apr 2026 · last used 01 Jul 2026 23:05 · 120 req / min

Legacy dispatch bridge

mrd_demo_77aa••••••••••••01c4

revoked

bookings.readfleet.read

Created 18 Nov 2025 · last used 22 May 2026 14:12 · 60 req / min

bookings.read — List and read bookings, status and allocation

bookings.write — Create, reschedule and cancel bookings

invoices.read — Read invoices, credit notes and tax buckets

payments.read — Read payments, 3DS2 outcomes and settlements

fleet.read — Read fleet units, chauffeurs and compliance status

tracking.read — Read live chauffeur position, status and ETA

Webhook endpoints

Tick the events each destination should receive. Deliveries retry with exponential backoff and pause after repeated failures.

https://portal.barrington-demo.co.uk/hooks/meridian

whsec_••••••••••••7f21 · 1,284 delivered / 3 failed (24 h) · 8 attempts · exponential backoff to 6 h

https://erp.groupe-vallier-demo.fr/api/meridian/events

whsec_••••••••••••1a04 · 612 delivered / 0 failed (24 h) · 8 attempts · exponential backoff to 6 h

https://payroll-demo.internal/meridian/settlements

whsec_••••••••••••93be · 41 delivered / 12 failed (24 h) · paused after 12 consecutive failures

Signature verification

Meridian-Signature: t=<unix>,v1=<hex>
v1 = HMAC_SHA256(secret, "<t>.<raw body>")
Compare with a timing-safe equality check and reject timestamps older than 5 minutes.

Sample payload

{
  "id": "evt_demo_0001",
  "type": "booking.status_changed",
  "created": "2026-07-02T09:14:02Z",
  "livemode": false,
  "data": {
    "ref": "LDN-24818",
    "market": "UK",
    "status": "en_route",
    "pickup": "The Berkeley, Wilton Place",
    "dropoff": "Heathrow T5",
    "pickup_at": "2026-07-02T09:40:00Z",
    "vehicle_class": "BUS",
    "chauffeur": {
      "name": "Priya Raman",
      "unit": "V-02"
    },
    "total": {
      "net": 118.33,
      "tax": 23.67,
      "gross": 142,
      "currency": "GBP"
    }
  }
}

Event	Destination	Sent	Attempt	Response	Payload
booking.status_changedevt_9f21a	https://portal.barrington-demo.co.uk/hooks/meridian	02 Jul 09:14:02Z	1 · 184 ms	200	`{"ref":"LDN-24818","status":"pob","chauffeur":"Priya Raman","eta_dropoff":"09:52Z"}`
invoice.createdevt_9f219	https://erp.groupe-vallier-demo.fr/api/meridian/events	02 Jul 08:00:11Z	1 · 233 ms	200	`{"number":"FR-2026-0512","account":"Groupe Vallier","net":11260,"tax":1216,"currency":"EUR"}`
payment.failedevt_9f214	https://erp.groupe-vallier-demo.fr/api/meridian/events	02 Jul 11:06:40Z	1 · 197 ms	200	`{"payment_id":"pi_demo_84131","reason":"3ds_challenge_abandoned","invoice":"INV-UK-2026-0839"}`
settlement.paidevt_9f1f8	https://payroll-demo.internal/meridian/settlements	01 Jul 18:22:09Z	8 · 30,000 ms	502	`{"settlement":"SET-UK-2026-31","driver":"James Okafor","payable":651.1,"currency":"GBP"}`