API Documentation

Access the Aevum Zenth ecosystem programmatically. Our RESTful API provides secure, scalable access to 400+ subsidiary services, unified under a single authentication layer and consistent data models.

All requests must be made over HTTPS. Calls made over plain HTTP will fail. API responses are returned in JSON format unless otherwise specified.

Authentication

Aevum Zenth uses API keys and OAuth 2.0 for authentication. Include your credentials in the Authorization header.

API Key Authentication

OAuth 2.0 (PKCE)

For user-level access to sensitive endpoints, implement the Authorization Code Flow with PKCE. Tokens expire after 1 hour.

Rate Limits

API limits are tiered based on your integration level. Default limits apply if no tier is specified.

Headers X-RateLimit-Limit, X-RateLimit-Remaining, and Retry-After are included in every response.

Companies

curl "https://api.aevumzenth.com/v2/companies?division=energy" \
  -H "Authorization: Bearer $ZENTH_API_KEY"

const res = await fetch('https://api.aevumzenth.com/v2/companies', {
  headers: { 'Authorization': `Bearer ${API_KEY}` }
});
const data = await res.json();

import requests

headers = {"Authorization": f"Bearer {API_KEY}"}
res = requests.get("https://api.aevumzenth.com/v2/companies", headers=headers)
data = res.json()

Transactions

Error Handling

The API uses standard HTTP status codes and returns machine-readable error objects.

Error response format:

{
  "error": {
    "code": "invalid_api_key",
    "message": "The provided API key has expired or is revoked.",
    "details": null,
    "request_id": "req_8x9m2k4p1"
  }
}

SDKs & Libraries

Official client libraries are available for rapid integration: