Getting started

The 7feastr Logistics API lets merchants create and track shipments, calculate delivery rates, and receive real-time status updates for their deliveries anywhere in Nigeria.

Base URL

Every request to the shipment, rate, wallet, and dispute endpoints goes through this base URL. The same paths serve both sandbox and production traffic, so switching environments only ever requires swapping your API key, never your integration code.

What you can do with the API

• Get an instant delivery quote for any two addresses in Nigeria, with weight-based pricing and an estimated time of arrival.
• Create a shipment and have it dispatched to a 7feastr delivery agent.
• Track a shipment's live status, either by tracking code (public, no authentication) or by shipment ID (authenticated).
• Get notified in real time via webhooks as a shipment moves through its lifecycle.
• Open and manage disputes on a shipment directly from your integration.
• Query your prepaid wallet balance and transaction history.

Where to manage your account

Everything account-related (business verification, API keys, webhook endpoints, wallet funding, and browsing your shipments in a UI) is handled from the merchant dashboard, a separate application from this API. This documentation only covers the HTTP API your own backend integrates with.

Quick example

curl -X POST https://api.7feastr.com/api/v1/logistics/v1/rates/estimate \
  -H "Authorization: Bearer SB_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "pickupAddress": "12 Admiralty Way",
    "pickupCity": "Lekki",
    "pickupState": "Lagos",
    "dropoffAddress": "5 Ademola Adetokunbo Street",
    "dropoffCity": "Wuse 2",
    "dropoffState": "Abuja",
    "packageWeightKg": 2.5
  }'

Continue to Authentication to learn how to get an API key, or jump straight to Quotes and shipments for the full creation flow.