Skip to content

AAJ Express API Documentation

API v2

Welcome to the official documentation for AAJ Express. Integrate seamlessly with Nigeria's leading logistics platform for domestic and international shipping.

RESTful
API Architecture
JSON
Data Format
API Key
Authentication

Quick Start

1. Authenticate

Get your API Key from the partner portal to authorize requests.

Get API Key →
2. Create Booking

Book a shipment with sender, receiver, and package details.

Create Booking →
3. Get Label

Process the booking to generate shipping labels and tracking ID.

Process Booking →
4. Track

Monitor your shipment's journey from pickup to delivery.

Track Shipment →

API Sections

Section Description
Authentication Obtain and manage access tokens
Quotes Calculate shipping rates and compare carriers
Booking Management Create, update, and manage bookings
Shipments Track and manage active shipments
Reference Data Static data for integration (HS codes, dimensions, etc.)

Base URL

All API requests should be made to:

BASE https://booking.aajexpress.org/api/v2

Authentication

All endpoints require a valid Bearer token in the Authorization header:

curl --request GET \
  --url 'https://booking.aajexpress.org/api/v2/endpoint' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json'

See Obtain Token for details on getting your access token.


Response Format

All responses are returned in JSON format with consistent structure:

{
  "statusCode": 200,
  "message": "Success message",
  "data": {
    // Response payload
  }
}

Rate Limiting

Tier Requests/Minute Burst Limit
Standard 60 100
Partner 300 500
Enterprise Unlimited Unlimited

Support

If you encounter any issues or have questions, please reach out to our technical team:


This documentation is maintained by AAJ Express Logistics. Last updated on December 11, 2025.