# AGT Names API

**Canonical:** https://apis.io/apis/agtnames-com/agtnames-com-api/  
**Provider:** AGT Names — https://apis.io/providers/agtnames-com/  
**Documentation:** https://agtnames.com/docs/api-reference

AGT Names API is published by [AGT Names](https://apis.io/providers/agtnames-com/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

AGT Names API as documented publicly: 28 operations. Contract generated from the documentation by API Evangelist (2026-11-01); not the provider's own document.

## Operations (28)

| Method | Path | Summary |
|---|---|---|
| POST | `/` | POST / |
| GET | `/.well-known/agt.json` | The registry described for machines: chain, contract addresses, API routes, feeds, install commands, the spec URL. |
| GET | `/activity/feed.json` | The newest 100 activity rows as JSON Feed 1.1. |
| GET | `/activity/feed.xml` | The newest 100 activity rows as Atom. |
| GET | `/api/agents` | The agent directory: every active name the indexer knows, with the endpoint records it has on chain and the capability ids from its verified manifest. |
| GET | `/api/badge/<label>.svg` | The on-chain identity badge for any valid label as SVG — the same art a mint embeds, so it renders for names that are not registered yet. |
| GET | `/api/badge/demoagent.svg` | GET /api/badge/demoagent.svg |
| POST | `/api/checkout` | Card checkout for a new name (Stripe Checkout with server-side price verification). |
| GET | `/api/checkout/status` | Poll fulfillment after a card payment. |
| GET | `/api/claim/status` | Legacy name Mint status for a name on the registry. |
| GET | `/api/health` | Health check endpoint. |
| POST | `/api/health` | POST /api/health |
| POST | `/api/notify` | POST /api/notify |
| GET | `/api/search` | GET /api/search |
| GET | `/api/v2/activity` | What happened on the registry: totals for every live name plus the last window by kind and recent events. |
| GET | `/api/v2/agent-card/{label}` | An A2A agent card for the name, built from its verified manifest. |
| GET | `/api/v2/agent-card/notary` | GET /api/v2/agent-card/notary |
| GET | `/api/v2/allowlist` | The migration allowlist. |
| POST | `/api/v2/manifest/pin` | Pin a signed v3 manifest whose signer is the name's current on-chain owner. |
| GET | `/api/v2/names` | Every Registry v2 name a wallet owns, from the index. |
| POST | `/api/v2/quote` | An EIP-712 registration or renewal quote for the on-chain checkout path. |
| POST | `/api/v2/zone-claim/challenge` | Start a zone-owner challenge and get the TXT record to add. |
| GET | `/api/v2/zone-claim/mine` | List zone-claim challenges owned by a wallet. |
| POST | `/api/v2/zone-claim/verify` | Check the TXT record. On success the label and wallet are queued for the next allowlist publication. |
| GET | `/llms-full.txt` | A plain‑text map of the docs plus the manifest specification and the full capability vocabulary. |
| GET | `/llms.txt` | A plain‑text map of the docs. |
| GET | `/mcp` | GET /mcp |
| GET | `/sitemap.xml` | Every docs, capability and name page; a name's lastmod is its newest activity row. |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/agtnames-com/openapi/_ae-authored/agtnames-com-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/agtnames-com/json-schema/agtnames-com-get-api-v2-agent-card-label-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/agtnames-com/json-schema/agtnames-com-get-api-search-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/agtnames-com/json-schema/agtnames-com-post-api-v2-manifest-pin-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/agtnames-com/json-schema/agtnames-com-post-api-v2-quote-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/agtnames-com/json-schema/agtnames-com-post-api-checkout-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/agtnames-com/json-schema/agtnames-com-get-api-claim-status-response-schema.json
- **APIsJSON** — https://artifacts.apis.io/agtnames-com/apis.yml

---

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