API Documentation

The Aevum Zenth API enables programmatic access to our enterprise data, division metrics, partnership workflows, and real-time analytics. All endpoints require authentication and follow RESTful conventions.

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

Responses are returned in JSON format. All timestamps are in ISO 8601 UTC format. Date filters use `YYYY-MM-DD` format.

Authentication

Access the API using Bearer tokens included in the `Authorization` header. Generate tokens via the developer console or through our OAuth 2.0 flow for server-to-server integrations.

cURL 
curl https://api.aevumzenth.com/v2/companies \
  -H "Authorization: Bearer sk_live_8f3a9c2d1e4b5f6a7g8h9i0j" \
  -H "Content-Type: application/json"

Token Types:

  • sk_live_* - Production access (full read/write)
  • sk_test_* - Sandbox environment (no live data)
  • sk_read_* - Read-only restricted access

Rate Limits

API requests are throttled based on your plan tier. Exceeding limits returns a 429 Too Many Requests response with a Retry-After header.

Plan Requests/min Burst Limit Daily Cap
Standard 60 120 50,000
Enterprise 600 1,200 5,000,000
Partner Custom Custom Unlimited

Companies

Retrieve or manage company profiles across the conglomerate structure.

GET /companies List all registered entities

Query Parameters

Parameter Type Description
divisionrequired string Filter by division slug (e.g., energy, aerospace)
status string active, inactive, acquired
limit integer Max records returned (default: 25, max: 100)

Response Example

JSON (200 OK) 
{
  "data: [
    {
      "id: "cmp_9283746510",
      "name: "Zenth Energy Solutions",
      "division: "energy",
      "status: "active",
      "headquarters: "Neo Geneva",
      "founded: "2018-04-12",
      "metrics: {
        "annual_revenue": 8400000000,
        "employees": 42500
      }
    }
  ],
  "pagination: {
    "next_cursor: "eyJpZCI6ImNtcF85MjgzNzQ2NTEwIn0",
    "has_more: true
  }
}

Divisions

Access metadata and performance indicators for each operational division.

POST /divisions/{id}/sync Trigger manual data synchronization

Path Parameters

Parameter Type Description
idrequired string Division identifier (e.g., div_aerospace_01)

Response Example

JSON (202 Accepted) 
{
  "status: "queued",
  "job_id: "sync_88a9b2c3d4e5",
  "estimated_completion: "2026-01-15T14:30:00Z",
  "webhook_url: null
}

Error Handling

The API uses standard HTTP status codes. Errors include machine-readable codes and developer-friendly messages.

400 Bad Request - Invalid parameters or malformed JSON
401 Unauthorized - Missing or invalid API key
403 Forbidden - Insufficient permissions for resource
404 Not Found - Resource does not exist
429 Too Many Requests - Rate limit exceeded
500 Internal Server Error - Retry or contact support

Error Response Format

JSON (400 Bad Request) 
{
  "error: {
    "code: "VALIDATION_FAILED",
    "message: "Missing required field: division_id",
    "field: "division_id",
    "request_id: "req_7f8a9b0c1d2e"
  }
}

SDKs & Libraries

Official client libraries are available for major languages. All SDKs handle authentication, retries, and pagination automatically.

Language Package Repository
Python pip install aevum-zenth github.com/aevum-zenth/sdk-python
JavaScript/TS npm install @aevum-zenth/sdk github.com/aevum-zenth/sdk-js
Go go get github.com/aevum-zenth/go-sdk github.com/aevum-zenth/sdk-go
Ruby gem install aevum_zenth github.com/aevum-zenth/sdk-ruby