API Documentation

Welcome to the Aevum Zenth Unified API. This RESTful interface provides programmatic access to our global enterprise data, financial instruments, operational metrics, and cross-divisional services. The API follows standard HTTP conventions, returns JSON responses, and supports OAuth 2.0 and API Key authentication.

curl -X GET https://api.aevumzenth.com/v3/entities \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

Base URL & Environments

All endpoints are prefixed with /v3. Versioning follows semantic versioning. Breaking changes will trigger a new major version with a 12-month deprecation notice.

Authentication

Aevum Zenth supports two authentication methods. API Keys are recommended for server-to-server integrations, while OAuth 2.0 is required for user-facing applications accessing scoped data.

API Key

Include your secret key in the X-Aevum-Key header or as a bearer token.

Authorization: Bearer az_live_sk_8f7a9b2c4d5e6f0123456789abcdef
X-Aevum-Key: az_live_sk_8f7a9b2c4d5e6f0123456789abcdef

OAuth 2.0

Use the standard authorization code flow. Supported scopes include entities:read, transactions:write, analytics:export.

Entities

Manage subsidiaries, divisions, and operational nodes within the conglomerate structure.

{
  "data": [
    {
      "id": "ent_9x8c7v6b5n4m3",
      "name": "Zenth Digital Systems",
      "division": "technology",
      "status": "active",
      "registered_date": "2021-04-12",
      "headquarters": {
        "city": "Neo Geneva",
        "region": "EMEA",
        "coordinates": { "lat": 46.2044, "lng": 6.1432 }
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 400,
    "has_more": true
  }
}

{
  "name": "Aevum Orbital Logistics",
  "division": "logistics",
  "type": "subsidiary",
  "compliance_tier": "tier_1",
  "initial_capital": 15000000,
  "currency": "USD"
}

Error Handling

The API uses conventional HTTP status codes and returns detailed error objects in the response body.

{
  "error": {
    "code": "rate_limited",
    "message": "Exceeded 100 requests/minute threshold.",
    "retry_after": 42,
    "documentation_url": "https://docs.aevumzenth.com/errors/rate-limited"
  }
}

Rate Limits

Rate limits are applied per API key and OAuth token. Standard tier allows 100 requests/minute, while Enterprise partners receive dedicated throughput with burst capacity.

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 1704067200
Retry-After: 15

SDKs & Libraries

Official client libraries are available for rapid integration. All SDKs are open-source, versioned, and maintained by the Zenth Digital Systems division.