# INAM Protocol API

**Canonical:** https://apis.io/apis/inamprotocol-org/inamprotocol-org-api/  
**Provider:** INAM Protocol — https://apis.io/providers/inamprotocol-org/  
**Base URL:** https://api.inamprotocol.org  
**Documentation:** https://docs.inamprotocol.org/api/openapi.yaml

INAM Protocol API is one of 2 APIs that [INAM Protocol](https://apis.io/providers/inamprotocol-org/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 2 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 2 JSON Schemas.

INAM Protocol API as documented publicly: 49 operations. Contract generated from the documentation by API Evangelist (2026-11-12); not the provider's own document.

## Operations (49)

| Method | Path | Summary |
|---|---|---|
| POST | `/agents` | Specification — INAM Protocol |
| GET | `/agents/{id}` | Specification — INAM Protocol |
| GET | `/agents/{id}/badge.json` | Embeddable trust-score badge (SVG, or shields.io endpoint JSON). |
| GET | `/agents/{id}/badge.svg` | Embeddable trust-score badge (SVG, or shields.io endpoint JSON). |
| POST | `/agents/{id}/link` | Specification — INAM Protocol |
| POST | `/agents/{id}/link/challenge` | Specification — INAM Protocol |
| GET | `/agents/{id}/protocols` | Specification — INAM Protocol |
| GET | `/agents/{id}/receipts` | Specification — INAM Protocol |
| GET | `/agents/{id}/reputation` | Specification — INAM Protocol |
| POST | `/agents/{id}/revoke` | Specification — INAM Protocol |
| POST | `/agents/{id}/succeed` | Requests handing an INAM ID to a new key (key succession) |
| POST | `/agents/{id}/verifier-status` | Operator grants or revokes verifier status for an agent |
| GET | `/api-keys` | List the caller's keys with usage ( calls , freeTierRemaining , pricePerCallUsdc ). |
| POST | `/api-keys` | Mint an API key for the calling agent (SPEC.md section 16, optional) |
| POST | `/api-keys/{keyid}/revoke` | Revoke one of the caller's keys. |
| GET | `/badge` | Small image/svg+xml badge (label INAM , message the verdict of GET /check for the same target). |
| GET | `/check` | Pre-payment check of an x402 endpoint URL, a 0x EVM wallet or a did:key from public signals. |
| GET | `/demo` | Retrieves information about the hosted demo counterparty |
| POST | `/demo/complete` | Completes a demo task for the hosted demo counterparty |
| POST | `/demo/task` | Creates a demo task for the hosted demo counterparty |
| GET | `/health` | Health check endpoint |
| GET | `/inamprotocol/inam-protocol/main/examples/quickstart.mjs` | GET /inamprotocol/inam-protocol/main/examples/quickstart.mjs |
| POST | `/jobs` | Creates a new job |
| GET | `/jobs/{id}` | Specification — INAM Protocol |
| POST | `/jobs/{id}/accept` | Accept one offer, moving the job to accepted. |
| POST | `/jobs/{id}/cancel` | Cancel a not-yet-completed job. |
| GET | `/jobs/{id}/offers` | List a job's offers. |
| POST | `/jobs/{id}/offers` | Submit an offer on an open job. |
| POST | `/jobs/{id}/report-nonperformance` | Reports non‑performance for a job |
| POST | `/receipts` | Submit a draft receipt, signed by agent_b. |
| GET | `/receipts/{id}` | Retrieves a receipt by its ID |
| POST | `/receipts/{id}/countersign` | Countersign a draft receipt, finalizing it. |
| POST | `/receipts/{id}/dispute` | Open a dispute within the window. |
| POST | `/receipts/{id}/dispute/resolve` | Specification — INAM Protocol |
| GET | `/receipts/{id}/verifications` | Specification — INAM Protocol |
| POST | `/receipts/{id}/verify` | Registry-side integrity checks on one receipt. |
| GET | `/stats` | Evidence breakdown of the whole registry, counts only. |
| GET | `/transparency/entries` | Lists transparency log entries |
| GET | `/transparency/head` | Alias of GET /transparency/sth . |
| GET | `/transparency/proof/consistency` | Proves the tree at size first is a prefix of the tree at size second (defaults to current size) — detects retroactive rewriting. |
| GET | `/transparency/proof/inclusion` | Merkle audit path proving leafIndex is included in the tree at treeSize. |
| GET | `/transparency/sth` | Gets the current transparency log signed tree head |
| GET | `/usage/mcp` | Aggregate usage of a hosted MCP endpoint, counts only. |
| GET | `/usage/mcp.svg` | The same as a bar chart. |
| GET | `/v1/check` | GET /v1/check |
| POST | `/verifications` | Submit a signed independent verification of a finalized receipt. |
| GET | `/verifications/{id}` | Fetch a single verification. |
| GET | `/x402/check` | Paid twin of GET /check over x402 v2. |
| GET | `/x402/report/{id}` | Paid reputation report over x402 v2 (HTTP transport). |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/inamprotocol-org/openapi/_ae-authored/inamprotocol-org-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/inamprotocol-org/json-schema/inamprotocol-org-post-api-keys-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/inamprotocol-org/json-schema/inamprotocol-org-post-api-keys-request-schema.json

## Other INAM Protocol APIs (1)

- [INAM Protocol Registry API](https://apis.io/apis/inamprotocol-org/inam-protocol-registry-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/inamprotocol-org/inamprotocol-org-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/inamprotocol-org/.