Endpoint Reference

https://api.aevumzenth.io/v3

API Overview

The Aevum Zenth API provides programmatic access to our global infrastructure, financial ledgers, telemetry streams, and enterprise services. All endpoints return JSON responses and require authentication via Bearer token or API key.

🌐 Base Version

Currently on v3. All responses include X-AZ-Request-ID for debugging. Legacy v1/v2 endpoints are deprecated and will sunset Q4 2026.

⚡ Real-time Streams

WebSocket endpoints available at wss://stream.aevumzenth.io/v3. Supports JSON, Protobuf, and MessagePack serialization.

📦 SDK Support

Official SDKs for Python, TypeScript, Go, and Rust. Auto-generated OpenAPI 3.1 specs available at /v3/openapi.json.

Authentication

Include your API key in the Authorization header. Enterprise tiers support OAuth 2.0 client credentials flow.

Header

Authorization: Bearer az_live_sk_8f9a2b3c4d5e6f7g8h9i0j
X-AZ-Client-ID: client_9x8y7z6w5v4u3t2s1r0q

Core Services

GET /status

System Health Check

Returns the operational status of all active Aevum Zenth divisions and regional endpoints.

Response (200)

{
  "status": "operational",
  "version": "3.8.2",
  "uptime": "99.998%",
  "regions": {
    "us-east": true,
    "eu-central": true,
    "ap-southeast": true,
    "me-south": true
  }
}

Energy & Power Grid

POST /energy/grid/load-balance

Request Load Balancing

Submit dynamic load balancing parameters to regional smart grids. Requires energy:write scope.

Request Body

{
  "region_id": "EU-DE-04",
  "priority": 2,
  "peak_threshold_mw": 850,
  "renewable_mix": {
    "solar": 0.45,
    "wind": 0.30,
    "fusion": 0.25
  }
}

Financial Ledger

GET /finance/transactions/{tx_id}

Retrieve Transaction

Fetch immutable ledger record for a specific transaction. Supports cross-border settlement data.

Response (200)

{
  "tx_id": "0x7f3a9b2c...",
  "timestamp": "2026-03-15T08:42:11Z",
  "amount": 1250000,
  "currency": "AZC",
  "status": "settled",
  "counterparty": "ent_9a8b7c6d5e",
  "compliance": {
    "aml_check": true,
    "jurisdiction": "CH-NE"
  }
}

Aerospace Telemetry

GET /aerospace/telemetry/{asset_id}/orbit

Orbital State Vector

Retrieve TLE/SGP4-compatible orbital data for registered satellites and orbital stations.

Response (200)

{
  "asset_id": "AZ-LEO-774",
  "epoch_utc": "2026-03-15T14:20:00Z",
  "latitude_deg": 41.2850,
  "longitude_deg": -73.9857,
  "altitude_km": 548.2,
  "velocity_ms": 7.61,
  "status": "nominal"
}

Health Data Sync

PUT /health/records/{patient_id}/sync

Update Clinical Record

HIPAA/GDPR-compliant endpoint for updating encrypted patient data. Requires signed payload.

Request Body

{
  "record_type": "vitals_stream",
  "data_enc": "eyJhbGciOiJSU0EtT0FFUCIs...",
  "auth_method": "E2EE-AES256-GCM",
  "audit_trail": true,
  "consent_id": "cc_88x99y00z"
}

Rate Limits & Errors

All endpoints enforce tiered rate limiting. Responses include X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers.

Common Status Codes

200 OK                    | Successful request
400 Bad Request           | Invalid payload or parameters
401 Unauthorized          | Missing or invalid API key
403 Forbidden             | Insufficient permissions/scope
429 Too Many Requests     | Rate limit exceeded
500 Internal Server Error | Transient grid/system failure