Developers

Build on the FleetRails API

REST, JSON, predictable webhooks. Sandbox keys in minutes.

Quickstart Auth Shipments Warehouse Webhooks Limits Status

From key to first shipment in four steps

Create your workspace (it comes with a sandbox).
Generate an API key in Settings → Developers.
POST /v1/shipments with your pickup and drop-off zones.
Poll the shipment, or subscribe to the shipment.delivered webhook.

# create a shipment
curl https://api.fleetrails.com/v1/shipments \
  -H "Authorization: Bearer fr_live_…" \
  -d '{"pickup":{"zone":"yaba"},"dropoff":{"zone":"lekki"},
       "customer":{"name":"Ada","phone":"+234…"}}'

Keys scoped to your workspace

Live and test keys are separate — sandbox data never touches production.
Rotate keys anytime from the console; old keys stay valid for 24 hours.
Treat secret keys like passwords: server-side only, never in browsers or mobile apps.

Shipments

POST/v1/shipmentsCreate a shipment

GET/v1/shipments/:idRetrieve one shipment

GET/v1/shipments?status=in_transitList by status

Warehouse

POST/v1/warehouse/receiptsRecord inbound stock

GET/v1/warehouse/stock?sku=SKU-1042Query available stock

POST/v1/warehouse/picksReserve and pick units

Push, so you don’t have to poll

Subscribe to events in the console. Every delivery is signed so you can verify it came from us.

POST https://yourapp.example/fleetrails-webhook
FR-Signature: t=1724508000,v1=5f8a…

{
  "event": "shipment.delivered",
  "data": {
    "id": "FR-48213",
    "delivered_at": "2026-08-24T13:58:04Z",
    "signed_by": "Ada O."
  }
}

Rate limits

120 requests per minute per key, with short bursts allowed. Hit the cap and you get a 429 with a Retry-After header — back off and retry.

Errors

Errors are JSON, always the same shape:

{"error":{"code":"zone_not_found","message":"…"}}

Environments & status

Live API	`api.fleetrails.com`
Sandbox API	`sandbox.api.fleetrails.com`
Tracking links	`trk.fleetrails.com`
Status page	status.fleetrails.com

Get a sandbox key today

Book a demo and we’ll flip the switch on your workspace.

Start free Request access