Wire delivery into whatever you already run.

A REST API your engineers won't fight. Create a request, and the moment a verified rider accepts, we hand your system a delivery and a live tracking link.

Quickstart

From zero to a rider on the way. About five minutes.

1. Install the SDK

npm install @dyspatch/node

2. Authenticate

Every request carries a secret key. Test keys start with sk_test_ and never move a real package.

terminal

export DYSPATCH_KEY="sk_test_xxxxxxxxxxxx"

Keep keys server-side

Secret keys must never appear in browser or mobile code. If one leaks, roll it from the dashboard — the old key dies instantly.

3. Create a request

Send a pickup, a drop-off and a package size. You get a request back — no delivery and no tracking link yet.

curl https://api.dyspatch.ng/v1/requests \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "pickup":  { "address": "12 Admiralty Way, Lekki" },
    "dropoff": { "address": "4 Adeola Odeku, V.I.",
                 "contact": { "name": "Ada", "phone": "+2348012345678" } },
    "package": "medium"
  }'

We track deliveries, not requests

A tracking link only exists once a rider accepts. Store the request_id and wait for the webhook.