Skip to main content
NewShipping API v1 is live

Deliveries, built into your product

Reeds delivers parcels across Lagos with its own riders and hubs. Quote, book and track deliveries from your checkout, store or platform, and pay per delivery from a prepaid wallet. Booked before 1:45 pm on a weekday, a parcel arrives the same day or the next working day.

Create a test accountStart the quickstart
POST /quotescURL
curl https://api.getreeds.co/shipping/v1/quotes \
  -H "Authorization: Bearer $REEDS_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "pickup_address_id": "adr_7Hq2Lk9P",
    "dropoff_address_id": "adr_5Vb1Jc8D",
    "package": {
      "description": "2 pairs of sneakers",
      "weight_kg": 1.5
    }
  }'
201 Createdtrimmed
{
  "status": "success",
  "data": {
    "id": "qt_2bX9Wn4K",
    "available": true,
    "route": { "type": "via_hub", "distance_km": 13.5 },
    "fee": { "total": 280000, "currency": "NGN" },
    "schedule": { "earliest_delivery": "2026-10-26T19:00:00+01:00", "deliver_by": "2026-10-27T19:00:00+01:00" },
    "expires_at": "2026-10-27T10:20:00+01:00"
  }
}
₦2,800 · today or tomorrow · price held for 24 hoursHow pricing works
Available

Shipping API

Addresses, quotes, deliveries, labels, webhooks and billing for deliveries across Lagos.

  • Quickstart
  • Delivery promise
  • Webhooks
Explore Shipping
Coming later

Stores API

Products, orders and storefronts for merchants who sell with Reeds. Its guides, reference and changelog join this hub when it is published.

Follow the changelog for news

Start building in three steps

Most teams make their first test booking in under an hour.

  1. 1

    Create a test account

    Sign up and verify your email and phone. You start in Test mode with a ₦100,000 test wallet. Create test credentials under Developers.

    Sign up
  2. 2

    Get an access token

    Exchange your client id and secret at POST /oauth/token for a one-hour bearer token. Any OAuth 2.0 library can do it.

    Authentication
  3. 3

    Book your first delivery

    Save the pickup and drop-off, get a quote, book with the quote id, then follow the parcel through webhooks.

    Quickstart

Explore the docs

Everything the Shipping API does, one topic at a time.

Addresses

Save who to collect from and deliver to. Imperfect addresses wait for confirmation.

Quotes

One Reeds price for a route, with VAT and the delivery promise, valid for 24 hours.

Deliveries

Book from a quote, track statuses, print labels and cancel with a full refund.

Drafts and required actions

Create a delivery now, start it once the address is confirmed and the item is packed.

Webhooks

Signed events for every status change, retried for two days, with a Resend button.

Wallet and invoices

Prepaid wallet by default, monthly invoicing for platforms.

Platforms and aggregators

Offer Reeds at your merchants’ checkouts with one-call quotes and a shipper block.

Testing

Recipes for every address outcome, and a simulator that moves test deliveries.

Three ways to ship with Reeds

All three run on the same logistics core, so a delivery behaves the same however it was booked.

Business account

Ship your own orders

Your store, ERP or ecommerce site calls the API with your own credentials, or your team books in the dashboard without code.

Platform account

Offer Reeds to your merchants

Aggregators and ecommerce platforms can list Reeds as a courier, name the merchant on each delivery and settle monthly.

Coming soon

Sell with a Reeds store

Stores built on Reeds book deliveries from inside Reeds when an order is paid. No integration to build.

No money at the door, on any channel. Riders never collect cash from receivers: businesses settle Reeds through a wallet or a monthly invoice.

Integrations

Ready-made ways to use Reeds without building an integration: what's available today, and what's planned.

Error codes

Every error code, what causes it, how to fix it and whether to retry. Error responses link straight here.

Need a hand?

Tell us what you’re building. Include the response’s X-Request-Id or your delivery id, never your client secret.

support@getreeds.coSupport options