Sustainability Impact API

Programmatically access real-time ESG metrics, carbon accounting data, and sustainability compliance reports across all 400 Aevum Zenth subsidiaries. Designed for enterprise integration, regulatory reporting, and impact tracking.

v2.4.1 · GA · Last updated Oct 2026

Authentication

All requests require authentication via API Key or OAuth 2.0 Client Credentials. Keys are scoped by division and data classification level.

Bearer Token / Authorization Header
Authorization: Bearer az_sust_live_sk_8x9k2m...
X-Division-Id: energy-europe-04
X-Data-Classification: esg-standard

Emissions & Carbon Accounting

Retrieve Scope 1, 2, and 3 emissions data, verified carbon credits, and neutralization targets.

GET /v2/emissions/{division_id} Stable

Returns aggregated emissions data for a specific division or subsidiary. Supports time-series filtering and verification status.

ParameterTypeDescription
division_idstringUnique division identifier Required
scopearrayFilter by scope: ["scope1", "scope2", "scope3"]
periodstringISO 8601 range (e.g., 2026-01/2026-06)
verifiedbooleanReturn only third-party verified data
cURL
curl -X GET "https://api.aevumzenth.com/v2/emissions/energy-europe-04?period=2026-01/2026-06&verified=true" \
  -H "Authorization: Bearer az_sust_live_sk_..."
JSON
{
  "division_id": "energy-europe-04",
  "period": "2026-01/2026-06",
  "emissions": {
    "scope1": { "value": 12450, "unit": "tCO2e", "verified": true },
    "scope2": { "value": 8920, "unit": "tCO2e", "verified": true },
    "scope3": { "value": 45300, "unit": "tCO2e", "verified": false }
  },
  "neutralization_rate": 0.84,
  "verification_body": "TÜV SÜD"
}
JSON
{
  "error": {
    "code": "INSUFFICIENT_PRIVILEGES",
    "message": "API key lacks ESG-Class-A clearance for this division.",
    "remediation": "Request elevated access via compliance@aevumzenth.internal"
  }
}
POST /v2/verify-carbon-credit Stable

Submit and validate purchased carbon removal/offset credits against internal ledger and blockchain registry.

ParameterTypeDescription
credit_idstringRegistry identifier (e.g., Verra, Gold Standard) Required
division_idstringClaiming division
retirement_datestringISO 8601 timestamp of retirement

Water & Energy Usage

Track facility-level water consumption, wastewater treatment, and grid/renewable energy ratios.

GET /v2/resources/facility/{facility_uuid} Beta

Returns real-time IoT telemetry and monthly aggregated reports for water/energy consumption.

Supply Chain Transparency

Access tier-1 through tier-3 supplier ESG ratings, material sourcing maps, and conflict mineral disclosures.

POST /v2/supply-chain/audit Stable

Initiate automated compliance audit against supplier database. Returns risk score and remediation steps.

ESG Scoring & Compliance

Generate standardized ESG scores aligned with SFDR, TCFD, and GRI frameworks. Supports custom weighting per division.

PUT /v2/esg/config/{division_id} Stable

Update division-specific ESG calculation weights and reporting frameworks.

Data Models

EmissionRecord

TypeScript
interface EmissionRecord {
  division_id: string;
  period: string; // ISO 8601 duration
  scope: 'scope1' | 'scope2' | 'scope3';
  value: number; // tCO2e
  unit: 'tCO2e' | 'kgCO2e';
  verified: boolean;
  verification_body?: string;
  methodology: 'GHG-Protocol' | 'ISO-14064' | 'CBAM';
  timestamp: string; // ISO 8601
}

Regulatory Alignment

All API endpoints are structured to support automated reporting for major sustainability frameworks.

🌍
GRI Standards
Fully Mapped
📊
SFDR (EU)
Article 8/9 Ready
🌡️
TCFD
Climate Scenario Support
⚖️
ISO 14001
Certified Integration

SDKs & Libraries

Official client libraries for seamless integration:

  • npm install @aevumzenth/sustainability-sdk (Node.js / Deno)
  • pip install aevum-zenth-sustain (Python 3.9+)
  • go get github.com/aevumzenth/sustainability-go
  • import AevumZenthSustain (Ruby, Java, C# wrappers available)

All SDKs include auto-retry, webhook polling, and schema validation out of the box.