Allometry · Docs · API
§ Beta · public API · Q3 2026

The Allometry API.

The same canonical graph your loops run on — exposed as v1 REST endpoints. Score addresses. Route decisions. Dispatch agents. Build on top of the substrate, not around it. Beta access opens Q3 2026 for design-partner cohort + select integrators.

Preview · core endpoints

Twelve endpoints. One graph.

The v1 surface covers the four loops: scoring an address, building a quote, dispatching a route, and writing back the variance. Full reference at GA. Endpoint shapes below are stable; payloads may evolve until beta.

POST/v1/accounts/:id/score
Score an account · composite Pulse
RESPONSE · 200 OK
{
  "account_id": "acct_8K2X",
  "composite": 0.84,
  "margin_score": 0.71,
  "risk_score": 0.22,
  "expansion_score": 0.68,
  "rationale": "margin_score steady · expansion signal from 3 new addresses · low risk on supplier concentration",
  "sop_cited": "processes/expand/account-score.md",
  "updated_at": "2026-05-11T14:22:11Z"
}
POST/v1/quotes
Build a margin-protected quote
REQUEST · application/json
{
  "account_id": "acct_8K2X",
  "items": [
    { "sku": "EVC-350-DC-CCS2", "qty": 56 }
  ],
  "address": "site_meridian_syr_04"
}
RESPONSE · 200 OK · 42ms
{
  "quote_id": "q_7H4Q",
  "total": 4210000,
  "margin_pct": 0.198,
  "floor_pct": 0.18,
  "status": "approved",
  "msa_terms_applied": ["volume_tier_-12", "net_45"],
  "signature_required": true
}
POST/v1/dispatch
Route a job to a crew · margin-aware
REQUEST · application/json
{
  "work_order_id": "wo_9E2M",
  "target_eta": "2026-05-12T14:00:00Z",
  "constraints": { "min_margin_pct": 0.22 }
}
GET/v1/accounts/:id/substrate
Read account substrate · CDP + DAM
RESPONSE · 200 OK · 19ms
{
  "account_id": "acct_8K2X",
  "cdp_fields": 312,
  "dam_assets": 38,
  "last_signal": "2026-05-11T12:08:00Z",
  "personalization_ready": true
}
POST/v1/workflows
Deploy a custom agent · fork SOP
REQUEST · application/json
{
  "sop_path": "processes/price/contract-renewal.md",
  "version": "v0.4-custom",
  "trigger": "renewal_window < 90d AND cost_drift > 0.05"
}
The mechanics

Auth · rate limits · webhooks.

§ 01 · Authentication

API keys + OAuth

v1 supports API keys for server-to-server + OAuth 2.0 for user-scoped operations. Per-key rate limits. Audit trail on every call (feeds Control & Governance).

§ 02 · Rate limits

10K requests / min · burst 50K

Generous limits at v1 — designed for full operational throughput, not API-as-product. Limits enforced per workspace, not per key. Webhooks counted separately.

§ 03 · Webhooks

State-change firings

Subscribe to canonical events: quote.created, dispatch.routed, margin.breach, renewal.opened. Signed payloads, retry with exponential backoff, dead-letter on 7-day timeout.

§ Beta access · limited

Build on the substrate.

The v1 API opens Q3 2026 to the design-partner cohort and select integrators. If you're building an operator-side integration, a data product on top of the canonical graph, or a custom agent that needs to dispatch into Allometry — join the list.