Logistics Provider Standard
Integrate your delivery service with MedsGH
One contract for every logistics provider: four calls, six statuses, and signed status callbacks. New providers receive credentials and configuration, never a different API.
X-Provider-Id: 3 X-Provider-Signature: 9f2c…e41a X-Event-Id: evt_7f3a91 X-Event-At: 2026-09-13T11:02:00Z { "job_id": "MG-1042-P17", "provider_reference": "uuu24Rres", "status": "in_transit", "at": "2026-09-13T11:02:00Z" }
Integration surface
Four calls
Three calls go from MedsGH to your API. Status events flow back to a per-job URL that MedsGH supplies with every job.
Price a trip. Returns a quote_reference that locks the price.
Hand over the job packet. Idempotent on Idempotency-Key.
Signed events POSTed to the job's callback_url.
Valid before pickup only.
Design
Contract guarantees
Fixed vocabulary
Six values: accepted, picked_up, in_transit, delivered, failed, cancelled. Unknown values are rejected, never inferred.
Verified delivery
delivered requires a verified customer OTP or a photo URL.
Idempotent booking
Resending a job with the same idempotency key returns the original booking.
Signed callbacks
HMAC-SHA256 signature, event timestamp window and event-id deduplication.
Documentation