Shipment

All shipment-related endpoints.

Get shipment rates.

post

This endpoint retrieves shipping rates. based on the provided shipment details including sender/receiver information, package dimensions, and items.

Header parameters

X-Shipment-ModestringOptionalExample: SFN

Body

application/json

boxesstring[]Required

Array of package boxes.

Example: ["architecto"]

last_mile_deliverybooleanOptional

optional Enable last mile delivery.

Example: true

pickupbooleanOptional

optional Enable pickup service.

Example: false

is_insuredstring · enumOptionalExample: 1Possible values:

Responses

200Success

text/plain

ResponsestringExample: { "success": true, "status_code": 200, "message": "Shipment rates retrieved successfully", "data": { "name": "Africanies Air Standard", "slug": "africanies_air_basic_sfn", "total_cost": 150.00, "currency": "USD", ... } }

500Error

application/json

post

/api/v1/shipment/rates

HTTPcURLJavaScriptPython

POST /api/v1/shipment/rates HTTP/1.1
Host: api-sandbox.africaniestest.com
Content-Type: application/json
Accept: */*
Content-Length: 108

{
  "addresses": [],
  "boxes": [
    "architecto"
  ],
  "units": [],
  "last_mile_delivery": true,
  "pickup": false,
  "is_insured": "1"
}

{
"success": true,
"status_code": 200,
"message": "Shipment rates retrieved successfully",
"data": {
  "name": "Africanies Air Standard",
 "slug": "africanies_air_basic_sfn",
  "total_cost": 150.00,
  "currency": "USD",
  ...
}
}

Track shipment.

post

This endpoint tracks a shipment using the shipment ID and tracking number.

Path parameters

tracking_numberstringRequired

The tracking number.

Example: TRK789012

Header parameters

X-Shipment-ModestringOptionalExample: SFN

Responses

200Success

application/json

500Error

application/json

post

/api/v1/shipment/track/{tracking_number}

HTTPcURLJavaScriptPython

POST /api/v1/shipment/track/{tracking_number} HTTP/1.1
Host: api-sandbox.africaniestest.com
Accept: */*

{
  "success": true,
  "status_code": 200,
  "message": "Shipment tracking retrieved successfully",
  "data": {
    "shipment_id": "SH123456",
    "tracking_number": "TRK789012",
    "status": "in_transit",
    "location": "Lagos, Nigeria",
    "estimated_delivery": "2024-01-20"
  }
}