Integration Overview

Welcome to the Aevum Zenth Integration API. This documentation provides comprehensive guidance for connecting your systems with our multidivisional enterprise platform, covering authentication, endpoints, webhooks, and SDK implementations.

ℹ️ API Version 2.1

All endpoints below use v2.1. Legacy v1 endpoints are deprecated and will sunset on Q4 2026. Please migrate accordingly.

Authentication

Aevum Zenth uses API Keys and OAuth 2.0 for authentication. Include your credentials in the Authorization header of every request.

curl -X GET https://api.aevumzenth.com/v2.1/divisions \  
  -H "Authorization: Bearer <YOUR_API_KEY>" \  
  -H "Content-Type: application/json"

const response = await fetch('https://api.aevumzenth.com/v2.1/divisions', {
  headers: {
    'Authorization': `Bearer ${YOUR_API_KEY}`,
    'Content-Type': 'application/json'
  }
});

const data = await response.json();

import requests

headers = {
    "Authorization": f"Bearer {YOUR_API_KEY}",
    "Content-Type": "application/json"
}

response = requests.get("https://api.aevumzenth.com/v2.1/divisions", headers=headers)
data = response.json()

OAuth 2.0 Flow

For user-scoped operations, implement the standard Authorization Code flow. Redirect users to:

https://auth.aevumzenth.com/oauth/authorize

Parameter	Type	Description
`client_id`*	string	Your application's client ID
`redirect_uri`*	URI	Registered redirect endpoint
`scope`*	string	Space-separated permissions: `read:divisions write:assets`
`response_type`	string	Must be `code`
`state`	string	CSRF protection token

Base URLs & Versioning

All production requests should target our global CDN endpoints. Region-specific routing is automatic based on your account tier.

Environment	Base URL	Purpose
Production	`https://api.aevumzenth.com/v2.1/`	Live operations
Sandbox	`https://sandbox.aevumzenth.com/v2.1/`	Testing & staging
Europe	`https://eu.aevumzenth.com/v2.1/`	GDPR-compliant routing

Divisions Endpoint

Retrieve, filter, and query operational divisions across the conglomerate portfolio.

GET /v2.1/divisions

GET /v2.1/divisions?sector=energy&status=active&limit=25

{
  "data": [
    {
      "id": "div_8x92k1",
      "name": "Aevum Energy & Power",
      "sector": "energy",
      "status": "active",
      "headquarters": "Neo Geneva",
      "revenue_usd": 12400000000,
      "created_at": "2018-04-12T08:30:00Z"
    },
    {
      "id": "div_4m3n7p",
      "name": "Zenth Digital Systems",
      "sector": "technology",
      "status": "active",
      "headquarters": "Neo Geneva",
      "revenue_usd": 18700000000,
      "created_at": "2019-11-05T14:20:00Z"
    }
  ],
  "meta": {
    "total": 400,
    "limit": 25,
    "offset": 0,
    "next_page": "/v2.1/divisions?sector=energy&status=active&limit=25&offset=25"
  }
}

Query Parameters

Parameter	Type	Required	Description
`sector`	string	No	Filter by operational sector: `energy`, `tech`, `aerospace`, `healthcare`, `finance`, etc.
`status`	string	No	`active`, `inactive`, `acquisition`, `divested`
`limit`	integer	No	Results per page. Max: 100. Default: 25.
`offset`	integer	No	Pagination cursor. Default: 0.

Rate Limits & Error Handling

API requests are throttled based on your subscription tier. Exceeding limits returns 429 Too Many Requests.

⚠️ Tier Limits

Starter: 60 req/min | Business: 600 req/min | Enterprise: Custom/Unlimited

Standard Error Responses

Code	Meaning	Resolution
`400`	Bad Request	Validate payload schema & parameters
`401`	Unauthorized	Check API key validity & expiration
`403`	Forbidden	Insufficient scope/account permissions
`404`	Not Found	Resource ID or endpoint may be deprecated
`422`	Validation Error	Review `errors[]` array in response body
`429`	Rate Limited	Implement exponential backoff
`5xx`	Server Error	Transient issue. Retry with jitter.

Webhooks

Subscribe to real-time events across divisions. Configure endpoints via the Developer Console.

POST /v2.1/webhooks

Webhook payloads include a signature header X-Aevum-Signature using HMAC-SHA256. Verify payloads before processing.

{
  "id": "evt_9x2m4k",
  "type": "division.asset.updated",
  "timestamp": "2026-01-15T10:32:00Z",
  "data": {
    "asset_id": "ast_7721",
    "division_id": "div_8x92k1",
    "new_value": 45000000,
    "previous_value": 42000000
  }
}

Official SDKs

Accelerate integration with our officially maintained client libraries. All SDKs support automatic retries, pagination helpers, and type safety.

Language	Package	Version
JavaScript/TS	`@aevumzenth/sdk-js`	v3.2.1
Python	`aevum-zenth`	v2.8.4
Go	`github.com/aevumzenth/go-client`	v1.4.0
Ruby	`aevum-zenth-rb`	v2.1.3