API Reference
Programmatic access to Aevum Zenth's multidivisional infrastructure, enterprise assets, market data, and cross-industry operations.
# Overview
The Aevum Zenth API provides RESTful endpoints for interacting with our 400+ subsidiaries, real-time market intelligence, asset tracking, and enterprise management systems. All requests and responses use JSON. The base URL for production is:
https://api.aevumzenth.com/v1
We follow standard HTTP conventions. Resources are pluralized and nested logically. Pagination uses cursor-based navigation for large datasets.
# Authentication
All API requests require authentication via Bearer tokens. Generate API keys from your Developer Dashboard. Include the token in the Authorization header:
curl -X GET https://api.aevumzenth.com/v1/companies \\ -H "Authorization: Bearer AZT_live_sk_8f92e1a..." \\ -H "Content-Type: application/json"
import requests headers = { "Authorization": "Bearer AZT_live_sk_8f92e1a...", "Content-Type": "application/json" } response = requests.get("https://api.aevumzenth.com/v1/companies", headers=headers) print(response.json())
const axios = require('axios'); axios.get('https://api.aevumzenth.com/v1/companies', { headers: { 'Authorization': 'Bearer AZT_live_sk_8f92e1a...' } }).then(res => console.log(res.data));
Never expose live keys in client-side code. Use AZT_test_ prefixes for sandbox environments.
# Rate Limits & Quotas
API access is tiered based on your subscription level. Exceeding limits returns 429 Too Many Requests with a Retry-After header.
| Tier | Requests/min | Burst | Data/Day |
|---|---|---|---|
| Developer | 120 | 20 | 50 MB |
| Professional | 1,000 | 100 | 2 GB |
| Enterprise | 5,000 | 500 | Unlimited |
# /companies
Retrieve a paginated list of all active subsidiary corporations and divisions.
| Parameter | Type | Description |
|---|---|---|
cursor | string | Pagination cursor from previous response |
limit | int | Items per page (max 100) |
industry | string | Filter by sector (e.g., aerospace, energy) |
{
"data": [
{
"id": "comp_8f92e1a7c",
"name": "Aevum Energy & Power",
"division": "energy",
"status": "active",
"revenue_ttm": 14200000000,
"founded": "2018-03-15"
}
],
"cursor": "eyJpZCI6NDAsImRhdGEiOiJib29r",
"has_more": true
}
# /divisions/{id}/assets
Register or sync a new enterprise asset within a specific division's inventory.
| Parameter | Type | Description |
|---|---|---|
asset_type | string | REQUIRED Category: infrastructure, hardware, intellectual_property |
metadata | object | Key-value pairs for asset attributes |
tags | array | Classification labels for internal routing |
# /market/data
Real-time and historical market intelligence across all operational sectors. Requires market_data scope.
Fetch aggregated market metrics, commodity prices, and sector performance indicators.
# Webhooks
Subscribe to real-time events via webhook endpoints. Events are signed with SHA256 using your webhook secret.
{
"id": "evt_9f82b3d1",
"type": "division.asset.registered",
"created_at": "2026-03-15T08:42:00Z",
"data": {
"division_id": "div_aerospace_01",
"asset_id": "asset_7f29c",
"status": "verified"
},
"signature": "sha256=3a8f92..."
}
# Error Codes
Aevum Zenth uses conventional HTTP status codes. Detailed error objects are returned in the response body.
| Code | Message | Description |
|---|---|---|
400 | Bad Request | Invalid parameters or malformed JSON |
401 | Unauthorized | Missing or invalid API key |
403 | Forbidden | Insufficient permissions for requested scope |
429 | Rate Limited | Exceeded request quota. Check Retry-After |
500 | Internal Error | Upstream service failure. Ticket auto-generated |
# SDKs & Libraries
Official client libraries available for rapid integration:
npm install @aevumzenth/sdk pip install aevumzenth gem install aevumzenth-ruby
Documentation for each SDK is available in the GitHub Monorepo.
# Support & Status
Monitor API uptime and incident history at status.aevumzenth.com. For technical support, open a ticket via the developer dashboard or email api-support@aevumzenth.com.