API Reference

Three public endpoints. Zero authentication for verification. Standard REST + JSON. Patent Pending USPTO 64/081,419.

Public Verifier API

POST https://verify.axiomaxllc.com/v1/verify

Validates an AXIOMAX ESG token against the registered client public key. Returns VALID + metrics or INVALID + reason.

curl -X POST https://verify.axiomaxllc.com/v1/verify \
  -H 'Content-Type: application/json' \
  -d '{"token": { ... your signed token JSON ... }}'

{
  "valid": true,
  "client_id": "acme_corp_2026",
  "n_inferences": 847392,
  "total_wh_saved": 21438.6,
  "total_co2_kg_saved": 8.253,
  "verified_at_utc": "2026-06-07T15:42:00Z"
}

GET https://verify.axiomaxllc.com/v1/health

Health check for monitoring integrations.

{"status":"ok","service":"axiomax_esg_verifier"}

ROI Calculator API

POST https://calc.axiomaxllc.com/v1/roi/calculate

Estimates monthly and annual savings from migrating cloud AI to AXIOMAX MIND. Public, no authentication.

curl -X POST https://calc.axiomaxllc.com/v1/roi/calculate \
  -H 'Content-Type: application/json' \
  -d '{
    "monthly_inferences": 500000,
    "avg_tokens_per_inference": 1500,
    "region": "us_east",
    "cloud_provider": "openai_gpt4_turbo"
  }'

Client Dashboard API (authenticated)

GET https://cliente.axiomaxllc.com/api/v1/metrics

Returns aggregated KPIs for authenticated client.

curl -u demo_client_001:demo_password_2026 \
  https://cliente.axiomaxllc.com/api/v1/metrics

GET https://cliente.axiomaxllc.com/api/v1/tokens/latest

Returns the most recent signed token JSON.

GET https://cliente.axiomaxllc.com/cert/{token_filename}

Generates and returns a PDF certificate from a signed token.

SDK / Client Libraries

Reference verifier implementations open-sourced:

pip install axiomax-esg-verify       # Python
npm install axiomax-esg-verify       # Node.js + browser

Source: github.com/axiomaxllc/esg-carbon-shield

SDK Quickstart — 5 minutes

Install the official SDK in Python or Node.js. Every AI inference auto-attested.

Python (OpenAI example)

pip install axiomax-esg-sdk

from axiomax_esg_sdk import AxiomaxClient, wrap_openai
import openai

axe = AxiomaxClient(license_key="axe_lic.YOUR_KEY...")
client = wrap_openai(openai.OpenAI(api_key="..."), axe)

# Use OpenAI normally - every call attested
response = client.chat.completions.create(
    model="gpt-4", messages=[{"role":"user","content":"hi"}])

# Periodically issue signed token
token = axe.issue_token()
print(token["signature_ed25519"])

Node.js (OpenAI example)

npm install @axiomax/esg-sdk

import OpenAI from "openai";
import { AxiomaxClient, wrapOpenAI } from "@axiomax/esg-sdk";

const axe = new AxiomaxClient({ licenseKey: "axe_lic.YOUR_KEY..." });
const client = wrapOpenAI(new OpenAI({ apiKey: "..." }), axe);

const response = await client.chat.completions.create({
  model: "gpt-4",
  messages: [{ role: "user", content: "hi" }],
});

const token = await axe.issueToken();

Docker on-premise (enterprise)

docker run -d -p 8888:8888   -e AXIOMAX_LICENSE_KEY="axe_lic.YOUR_KEY..."   axiomax/esg-shield-emisor:1.0.0

# Apps POST to local emisor
curl -X POST http://localhost:8888/v1/record   -H 'Content-Type: application/json'   -d '{"model_id":"gpt-4","tokens_in":120,"tokens_out":340,"duration_ms":1800}'

Get a license key

Request your license at signup.axiomaxllc.com — 24 hour approval, free trial available.

OpenAPI 3.0 Specification

Machine-readable schema for all public endpoints.

curl -O https://axiomaxllc.com/openapi.yaml

Import into Postman, Insomnia, Swagger UI, or any OpenAPI-compatible tool.

Token format spec

Complete specification at github.com/axiomaxllc/esg-carbon-shield.