Delivery API Documentation

Create One, Create Bulk, Get One, and Cancel endpoints.

API v1Bearer Auth

Overview

All endpoints require a valid business API key via the Authorization: Bearer <API_KEY> header

Base URL/api/v1

Operating Countries & Hubs

Loading operating countries…

Create One Delivery

POST /api/v1/delivery/create-one

POSTJSON

Authentication

Type:Bearer Token

Authorization: Bearer <API_KEY>

Requests without valid credentials return 401 Unauthorized.

Request Body (JSON)

Field	Type	Required	Description
oc_key	string	✅ Yes	Operating country key.
hub_key	string	✅ Yes	Operating country hub key.
dropoff_address	string	✅ Yes	Full address for delivery drop-off.
recipient_name	string	✅ Yes	Recipient's full name.
recipient_phone	string	✅ Yes	Recipient's contact number.
recipient_email	string	Optional	Recipient's email address.
recipient_notes	string	Optional	Delivery notes or additional instructions.
recipient_package_weight	number	✅ Yes	Package weight value.
recipient_package_weight_unit	string	✅ Yes	Package weight unit. Allowed values: G, KG, LBS.
package_reference_code	string	✅ Yes	Business-provided package reference, barcode value, or QR reference.

Example Request

bash
curl -X POST /api/v1/delivery/create-one \
  -H "Authorization: Bearer df_test_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "oc_key": "BAHA",
    "hub_key": "NAS01",
    "dropoff_address": "East Street South, Nassau, New Providence, Bahamas",
    "recipient_name": "Alano Rolle",
    "recipient_phone": "+1 242 359 1842",
    "recipient_email": "alano.rolle@example.com",
    "recipient_notes": "Please deliver to the front desk",
    "recipient_package_weight": 2.5,
    "recipient_package_weight_unit": "KG",
    "package_reference_code": "QR-ORDER-10001"
  }'

Example Success (200)

json
{
  "success": true,
  "delivery_id": "DF-20260308-K92JDX",
  "message": "Delivery created successfully"
}

Errors

Returned when a required field is missing, or when invalid input is provided.
Examples:
{ "error": "oc_key is required" }
{ "error": "Invalid JSON payload" }
{ "error": "package_reference_code is required" }
{ "error": "recipient_package_weight_unit must be one of: G, KG, LBS" }