---
title: Gateway API
description: Read the actual HTTP contract, authentication boundaries, errors and integer amount conventions.
---

The gateway reference is generated from the repository OpenAPI contract. [Open the native reference](/reference) or [the Scalar renderer](/scalar).

Owner and merchant operations require a verified Clerk session. Agent operations require verified AgentID identity and the configured ownership policy. A 401 indicates missing or invalid authority; 403 indicates insufficient permission; 402 describes a required payment action; 503 indicates unavailable configuration.

Amounts use integer microcredits represented as decimal strings in JSON. USD requests use integer cents. Use stable idempotency keys for retries of financial and fulfillment operations.

The Blume [JSON documentation API](/docs/discovery) is a separate read-only surface at `/api/docs/*`; it does not execute gateway transactions.