Authentication

All API endpoints require a Bearer token. You can generate an API Key from theDeveloper Settingsin your portal.

Authorization: Bearer mpx_your_api_key_here

Rate Limiting

API requests are limited to 100 requests per day per key. Ensure you use Webhooks for real-time updates instead of polling the API to conserve your limits.

Endpoints

1. Create Pre-Alert (Incoming Package)

POST /api/v1/packages/incoming

Notify MPX that a package is en route to our warehouse. This saves you from having to enter it manually.

{
  "tracking_number": "1Z9999999999999999",
  "item_description": "Electronics",
  "courier_company": "UPS",
  "origin_warehouse": "Guangzhou Main Hub"
}

2. List Active Shipments

GET /api/v1/shipments

Returns an array of up to 100 of your active shipments and their current statuses.

3. Track a Specific Shipment

GET /api/v1/shipments/track?tracking_number=YOUR_TRACKING

Returns detailed tracking history and current status for a specific shipment.

Webhooks

You can register a webhook URL in your Developer Settings. MPX will send a POST request to your URL whenever a shipment's status changes.

// Webhook Payload Example
{
  "event": "shipment.updated",
  "timestamp": "1710000000",
  "data": {
    "hawb_number": "MPX-123456",
    "tracking_number": "1Z9999999999999999",
    "status": "Arrived at Destination",
    "origin": "Guangzhou Main Hub",
    "destination": "Harare"
  }
}

Security: All webhook requests include an mpx-signature header containing an HMAC SHA-256 signature. You can use your Webhook Secret to verify the payload was sent by MPX.

MPX Global API Documentation