Aevum Zenth

Overview

The Aevum Zenth Logistics API provides programmatic access to our global freight network, automated warehousing systems, and predictive routing engine. All endpoints return JSON responses and support standard HTTP methods.

Base URL: https://api.aevumzenth.com/logistics/v1
Sandbox: https://sandbox-api.aevumzenth.com/logistics/v1

Authentication requires a valid API key and OAuth 2.0 bearer token. Enterprise clients receive dedicated rate limit tiers and webhook callback endpoints.

Authentication

All requests must include the Authorization header with a Bearer token, and the X-AZ-API-KEY header for service identification.

curl -X GET https://api.aevumzenth.com/logistics/v1/shipments/AZ-8842X \n  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR..." \n  -H "X-AZ-API-KEY: az_live_9f8e7d6c5b4a3210" \n  -H "Content-Type: application/json"

import requests

headers = {
    "Authorization": "Bearer eyJhbGciOiJSUzI1NiIsInR...",
    "X-AZ-API-KEY": "az_live_9f8e7d6c5b4a3210"
}

response = requests.get(
    "https://api.aevumzenth.com/logistics/v1/shipments/AZ-8842X",
    headers=headers
)
print(response.json())

const response = await fetch('https://api.aevumzenth.com/logistics/v1/shipments/AZ-8842X', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer eyJhbGciOiJSUzI1NiIsInR...',
    'X-AZ-API-KEY': 'az_live_9f8e7d6c5b4a3210',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

Shipments & Tracking

Create, retrieve, and monitor freight movements across air, sea, and ground networks. Supports multi-modal routing and customs clearance status updates.

Method	Endpoint	Description
GET	/shipments/{id}	Retrieve detailed shipment info
POST	/shipments	Create a new freight order
GET	/shipments/{id}/tracking	Real-time GPS & checkpoint status
PUT	/shipments/{id}/route	Override or modify transit path

Response Schema Example

{
  "id": "AZ-8842X",
  "status": "in_transit",
  "origin": { "facility": "AZ-HUB-TPE", "city": "Taipei", "country": "TW" },
  "destination": { "facility": "AZ-HUB-JFK", "city": "New York", "country": "US" },
  "eta": "2026-08-14T08:30:00Z",
  "mode": "air_freight",
  "weight_kg": 4250.5,
  "customs_cleared": true,
  "last_update": "2026-08-10T14:22:11Z"
}

Route Optimization

Leverage our proprietary ZenthRoute™ engine for multi-stop logistics planning. Accounts for fuel efficiency, driver hours, toll costs, and real-time traffic/weather disruptions.

Method	Endpoint	Description
POST	/routes/optimize	Calculate optimal multi-stop path
GET	/routes/{id}/telemetry	Live route deviation alerts

Warehouse & Inventory

Manage stock levels, automate pick/pack workflows, and sync inventory across regional fulfillment centers. Supports RFID, barcode scanning, and AGV coordination.

Method	Endpoint	Description
GET	/warehouses/{id}/inventory	Current stock levels
POST	/warehouses/{id}/transfers	Initiate inter-facility stock movement
POST	/warehouses/{id}/agv/commands	Dispatch automated guided vehicles

Rate Limits

API access is throttled based on your account tier. Exceeding limits returns 429 Too Many Requests.

Standard: 1,000 requests / minute
Enterprise: 5,000 requests / minute
Webhook callbacks: 100 / second burst

Headers X-RateLimit-Limit and X-RateLimit-Remaining are included in every response.

Webhooks

Subscribe to real-time events instead of polling. Register endpoints via the Developer Dashboard or via the /webhooks resource.

{
  "event": "shipment.status_changed",
  "data": {
    "shipment_id": "AZ-8842X",
    "previous_status": "processing",
    "current_status": "departed_origin",
    "timestamp": "2026-08-10T09:15:00Z"
  }
}

Error Handling

The API uses standard HTTP status codes and returns structured JSON error objects.

400

Invalid request format or missing parameters

401

Missing or expired authentication token

403

API key lacks permission for this resource

404

Resource not found

429

Rate limit exceeded. Retry after X-RateLimit-Reset

500

Internal server error. Contact az-support@aevumzenth.com

SDKs & Tools

Official client libraries and integration tools are available for rapid deployment.

Python: pip install aevum-zenth-logistics
Node.js: npm install @aevumzenth/logistics-sdk
Java/Kotlin: Maven Central com.aevumzenth:logistics-client
GraphQL: https://api.aevumzenth.com/logistics/graphql

Postman collections and Swagger/OpenAPI 3.0 specs are available in the Developer Hub.