API Documentation

Overview

The Aevum Zenth REST API follows standard HTTP semantics and uses JSON for all request/response payloads. All endpoints are accessed via HTTPS. Pagination, filtering, and rate limiting are standardized across all industry divisions.

Base Structure

                        JSON
                        
                    
{
  "api_version": "2.4.1",
  "timestamp": "2026-01-15T08:30:00Z",
  "environment": "production",
  "endpoints": "https://api.aevumzenth.com/v2/*"
}

Authentication

All API requests must include a valid authentication token. Aevum Zenth supports three authentication methods:

1. Bearer Token (Recommended)

Include your API key in the Authorization header:

HTTP Header

Authorization: Bearer az_live_8f92a3b1c4d5e6f7890123456789

2. API Key Parameter

Pass the key as a query parameter for webhook callbacks:

Query String

?api_key=az_live_8f92a3b1c4d5e6f7890123456789

3. OAuth 2.0 (Enterprise)

For cross-divisional integrations, use the OAuth 2.0 Authorization Code flow. Scopes are mapped to division access levels (e.g., `energy:read`, `healthcare:write`, `finance:execute`).

Rate Limits

Rate limits are applied per API key and vary by tier and endpoint criticality. Limits reset on a rolling window basis.

Plan	Requests/min	Burst Limit	Data Egress
Developer	60	100	50 MB/mo
Professional	600	1,000	5 GB/mo
Enterprise	6,000	10,000	Unlimited

When limits are exceeded, the API returns 429 Too Many Requests with a Retry-After header indicating seconds until reset.

Endpoints

Core: Divisions

GET /divisions ▼

Retrieve a paginated list of all active subsidiaries and operational divisions across the conglomerate.

Parameter	Type	Description
page	integer	Pagination index (default: 1)
limit	integer	Items per page (max: 100, default: 20)
status	string	Filter by status: `active`, `acquiring`, `inactive`

cURL
curl -X GET "https://api.aevumzenth.com/v2/divisions?page=1&limit=20" \n  -H "Authorization: Bearer az_live_..."

JSON
{
  "data": [
    {
      "id": "div_8f92a3b1",
      "name": "Aevum Energy & Power",
      "sector": "energy",
      "status": "active",
      "hq": "Dubai, UAE"
    },
    {
      "id": "div_7c81b2a0",
      "name": "Zenth Digital Systems",
      "sector": "technology",
      "status": "active",
      "hq": "Neo Geneva"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 412
  }
}

POST /energy/grid/deploy ▼

Initiate a smart grid deployment or load-balancing protocol. Requires elevated `energy:admin` scope. Triggers real-time telemetry streaming via WebSocket.

Parameter	Type	Description
region_id	string	Required
protocol	string	`load_balance`, `peak_shave`, `microgrid_isolate`
threshold_kw	number	Activation threshold in kilowatts

JSON
{
  "region_id": "me_dubai_central",
  "protocol": "peak_shave",
  "threshold_kw": 45000,
  "duration_h": 2.5
}

JSON
{
  "deployment_id": "dep_9f82c3d1",
  "status": "queued",
  "estimated_activation": "2026-01-15T08:35:12Z",
  "telemetry_ws": "wss://api.aevumzenth.com/v2/energy/stream/dep_9f82c3d1"
}

GET /aerospace/satellites/{sat_id}/telemetry ▼

Retrieve real-time or historical telemetry data for Zenth Aerospace satellite constellations. Supports time-range filtering and data point sampling.

Parameter	Type	Description
sat_id	string	Required. Satellite identifier
start_time	datetime	ISO 8601 start timestamp
end_time	datetime	ISO 8601 end timestamp
sample_rate	string	`1s`, `5s`, `1m`, `5m`

JSON
{
  "satellite": "ZENTH-ORB-042",
  "status": "nominal",
  "telemetry": [
    {
      "timestamp": "2026-01-15T08:30:00Z",
      "altitude_km": 548.2,
      "velocity_kms": 7.61,
      "temperature_c": -12.4,
      "power_watts": 3420
    }
  ],
  "points_returned": 144
}

PUT /healthcare/patient/{patient_id}/records ▼

Update or append to a patient's electronic health record. Enforces HIPAA/GDPR compliance with automatic audit logging. Requires `healthcare:write` scope.

Parameter	Type	Description
patient_id	string	Required
record_type	string	`vitals`, `diagnosis`, `prescription`, `imaging`
data	object	Required. FHIR-compliant JSON structure

DELETE /finance/webhooks/{hook_id} ▼

Revoke and permanently delete a registered financial event webhook. Stops all future delivery for trading settlements, compliance alerts, and liquidity reports.

JSON
{
  "success": true,
  "webhook_id": "whk_7a91c2d3",
  "message": "Webhook successfully revoked and purged from event bus."
}

SDKs & Libraries

Official client libraries are maintained for rapid integration. Community-maintained wrappers are available via the Aevum Zenth Developer Hub.

Language	Package	Repository
Python	`pip install aevum-zenth`	GitHub
Node.js	`npm install @aevumzenth/sdk`	GitHub
Go	`go get github.com/aevumzenth/go-sdk`	GitHub
Rust	`cargo add aevum-zenth`	Crates.io

Developer Support

Need help integrating? Our engineering team is available across all time zones.

📧 Email: developers@aevumzenth.com
💬 Discord: discord.gg/aevumzenth-dev
📖 Status Page: status.aevumzenth.com