API Reference

Programmatic access to Aevum Zenth's 400+ subsidiary operations. RESTful, JSON-based, and designed for scale.

Base URL https://api.aevumzenth.com/v2

Auth Method Bearer Token

Rate Limit 1,200 req/min

Response Format application/json

Authentication

All API requests require authentication via API Key or OAuth 2.0. Include your token in the Authorization header.

curl -X GET https://api.aevumzenth.com/v2/divisions \\
  -H "Authorization: Bearer zenth_live_9x7k2m..." \\
  -H "X-AZ-Organization: aevum-global"

Header	Description	Required
`Authorization`	Bearer token for authentication	Yes REQUIRED
`X-AZ-Organization`	Scopes requests to your tenant	Recommended
`X-AZ-Idempotency-Key`	Prevents duplicate POST/PUT ops	Optional

List Divisions

GET /divisions

Returns a paginated list of all active Aevum Zenth subsidiaries and operational divisions.

Parameter	Type	Description
`page`	integer	Page number (default: 1)
`limit`	integer	Results per page (max: 100)
`sector`	string	Filter by industry vertical

{
  "data": [
    {
      "id": "div_8x29a1z",
      "name": "Aevum Energy & Power",
      "sector": "renewable_energy",
      "status": "active",
      "endpoint_prefix": "/v2/energy"
    }
  ],
  "meta": {
    "page": 1,
    "has_more": true,
    "total": 402
  }
}

Register Smart Meter

POST /energy/meters

Onboards a new IoT smart meter to the Aevum Energy grid telemetry network.

{
  "device_id": "mtr_99283kx",
  "location": {
    "lat": 47.3769,
    "lon": 8.5417,
    "region_code": "CH-ZH"
  },
  "firmware": "v4.2.1-zenth",
  "telemetry_interval_s": 300
}

Error Handling

Aevum Zenth uses standard HTTP status codes. All errors return a consistent JSON structure with machine-readable error codes.

Code	Meaning	Description
200	OK	Request succeeded
401	Unauthorized	Invalid or missing API key
403	Forbidden	Insufficient scope or region access
429	Too Many Requests	Rate limit exceeded
503	Service Unavailable	Division undergoing maintenance

Rate Limits & Quotas

To maintain global stability across 340K+ endpoints, requests are throttled per API key. Limits vary by tier.

"X-AZ-RateLimit-Limit": 1200
"X-AZ-RateLimit-Remaining": 1142
"X-AZ-RateLimit-Reset": 1718294400

Webhooks

Subscribe to real-time events across divisions. Configure endpoints in the Developer Portal.

Event	Description
`division.created`	New subsidiary registered
`energy.grid.alert`		Load imbalance detected
`tech.model.deployed`	AI model pushed to production
`finance.tx.completed`	High-value transaction settled