MGR Merchant API

Getting an API key

Contact api@mgrcouriers.com or your account manager. Sandbox keys issued same-day; production after KYC.

Endpoints

POST   /api/v1/quote         -> instant rate
POST   /api/v1/shipments     -> create a shipment
GET    /api/v1/shipments/:id -> status + tracking
GET    /api/v1/track/:id     -> public tracking (no auth)
POST   /api/v1/pickups       -> schedule pickup
POST   /api/v1/webhooks      -> subscribe to events
GET    /api/v1/schedule      -> upcoming sailings
GET    /api/v1/rates         -> full rate card

Webhook events

• shipment.created, shipment.picked_up, shipment.at_port,
  shipment.in_transit, shipment.cleared, shipment.delivered
• payment.succeeded, payment.failed, payment.refunded
• manifest.accepted, customs.cleared

Sample: create a shipment

curl -X POST https://api.mgrcouriers.com/v1/shipments \
  -H "Authorization: Bearer rof_sk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "type":"Barrel", "from":"Hollywood, FL", "to":"Kingston",
    "weight_lb":185, "declared_value":600,
    "consignee":{"name":"Jane Doe","phone":"+18765551234"},
    "insurance":true, "carbon_offset":true
  }'

Rate limits

100 req/min sandbox, 1000 req/min production. Bulk endpoints accept up to 500 items per call.