API reference

A small, deterministic API: propose, counter, accept — and read the record.

POST /v1/negotiations

Open a negotiation against a template version with a connected counterparty.

GET /v1/negotiations/{id}

Current state, sequence number and latest terms.

POST /v1/negotiations/{id}/proposals

Propose or counter terms. Values are validated against the template schema and your policy rules.

POST /v1/negotiations/{id}/accept

Accept the latest terms. Returns 202 held_at_gate when a threshold applies.

GET /v1/negotiations/{id}/record

The ordered, attributed audit record; ?format=pdf for the evidence pack.

GET /v1/templates

The template library with version streams.

GET /v1/commitments/{id}

Gate status of a held commitment: reason, governor, window.

POST /v1/webhooks

Subscribe to lifecycle events. Deliveries are HMAC-signed.

Accepting above a threshold

POST /v1/negotiations/neg_7f3a92/accept
→ 202 Accepted
{
  "status": "pending-approval",
  "commitment": "com_2091",
  "held_because": ["value_threshold", "irreversible"],
  "routed_to": "governor:r.osei",
  "window_closes": "2026-07-24T09:01:55Z",
  "sequence": 14
}