v4.0.0
Status Get API Key

Aevum Zenth Unified API Gateway

Programmatic access to 400 subsidiaries across 47 industries. The v4.0.0 gateway provides unified authentication, cross-divisional orchestration, and real-time telemetry for enterprise integration.

All Systems Operational
REST + GraphQL
99.99% SLA
HSM Encrypted Keys
Base URL
https://api.aevumzenth.global/v4

Authentication

All requests to the Aevum Zenth API require authentication via API Keys or OAuth 2.0 Bearer Tokens. Keys are HSM-encrypted and rotated automatically every 90 days.

API Key (Header)

Include your API key in the X-AZ-Key header.

X-AZ-Key: az_live_8f9a2b3c4d5e6f7g8h9i0j1k2l3m4n5o

OAuth 2.0 (Bearer)

Use for user-context operations in divisional systems.

Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...

Web Signatures

Enterprise tier requires RSA-256 signed request bodies.

X-AZ-Signature: SHA256=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6
Core System
GET /system/status

Returns the current operational status of the unified gateway and active divisional nodes.

curl "https://api.aevumzenth.global/v4/system/status" \
  -H "X-AZ-Key: az_live_8f9a2b3c..."
import aevumzenth

client = aevumzenth.Client(api_key="az_live_8f9a2b3c...")
status = client.system.get_status()
print(status.json)

Response

{
  "gateway_version": "4.0.0",
  "status": "operational",
  "latency_ms": 42,
  "active_divisions": 400,
  "regions": {
    "us-east-1": "healthy",
    "eu-central-1": "healthy",
    "apac-tokyo": "healthy"
  }
}
GET /tenants

List all accessible tenant entities (subsidiaries, joint ventures, or project codes).

Query Parameters

NameTypeRequiredDescription
division string Filter by division code (e.g., ENERGY, FINANCE)
region string Filter by ISO region code
limit integer Max results (default: 50)
Energy & Power Division
GET /energy/grids/{grid_id}/realtime

Retrieve real-time load, frequency, and distribution metrics for a specific smart grid node.

Path Parameters

NameTypeRequiredDescription
grid_idstringRequiredUnique grid identifier
POST /energy/renewable/schedule

Schedule renewable generation output based on predictive weather models and demand forecasts.

Request Body

{
  "facility_id": "az-solar-neo-geneva-01",
  "start_time": "2026-08-15T06:00:00Z",
  "duration_hours": 6,
  "target_mw": 450.5,
  "storage_backup": true
}
Finance & Capital Group
POST /finance/swift/batch

Initiate a batch of cross-border transactions via integrated SWIFT network with automated compliance checks.

Note: Requires HIGH_PRIVILEGE role and dual-signature authentication.

Aerospace & Defense
GET /aerospace/satellites/{sat_id}/telemetry

Fetch live telemetry data for orbital assets including orbital parameters, health metrics, and downlink status.

Rate Limits

Rate limits are enforced per API key and per endpoint group. Limits reset every 60 seconds.

TierRequests / minBurstConcurrent
Free 1,000 50 10
Professional 50,000 500 100
Enterprise 500,000 5,000 Unlimited

Error Codes

200 OK. Request successful. 201 Created. Resource successfully created. 400 Bad Request. Invalid parameters or malformed JSON. 401 Unauthorized. Invalid or missing API key. 403 Forbidden. Insufficient permissions for divisional endpoint. 429 Too Many Requests. Rate limit exceeded. 500 Internal Server Error. Gateway processing failure. 503 Service Unavailable. Maintenance or divisional node outage.