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
OAuth 2.0
Authentication

Quick Start

1. Authenticate

Obtain an access token to authorize your API requests.

Get Token →
2. Get a Quote

Calculate shipping rates based on origin, destination, and weight.

Create Quote →
3. Create Booking

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

Create Booking →
4. Track Shipment

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://api.aajexpress.org/api/v2

Authentication

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

curl --request GET \
  --url 'https://api.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 04, 2025.