# Agnic API Reference API

**Canonical:** https://apis.io/apis/agnic-ai/api-reference-api/  
**Provider:** Agnic — https://apis.io/providers/agnic-ai/  
**Base URL:** https://api.agnic.ai  
**Documentation:** https://docs.agnic.ai/docs/api-reference

Agnic API Reference API is one of 3 APIs that [Agnic](https://apis.io/providers/agnic-ai/) publishes 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.

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

## Operations (17)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/agent/credential` | Returns the agent's SD-JWT trust credential (used by merchants for identity verification). |
| GET | `/api/agent/email` | Returns alias info, or `{ hasEmail: false }` if not provisioned. |
| POST | `/api/agent/email` | Creates the alias. Idempotent — re-posting with a new `displayName` updates it in place. Requires an active KYA agent. |
| GET | `/api/agent/email/inbox` | Returns inbound and outbound messages, newest first. |
| POST | `/api/agent/email/reply` | Replies to an inbox message. Sets `In-Reply-To`/`References` headers automatically. Marks the original as read. |
| POST | `/api/agent/email/send` | Sends from the agent's address. Plain text only (HTML not supported on send today). |
| GET | `/api/agent/identity` | Returns the active agent's ERC-8004 identity. `agentId` is the on-chain KYA registration ID. |
| GET | `/api/autofill/cards` | The cards this user has vaulted |
| POST | `/api/autofill/explore` | Onboard a merchant nobody has bought from before |
| GET | `/api/autofill/merchants` | GET /api/autofill/merchants |
| GET | `/api/autofill/merchants/{id}` | One merchant, with its catalogue when it has one |
| GET | `/api/autofill/orders` | Recent orders for the authenticated user |
| GET | `/api/autofill/orders/{id}` | One order, with the failure contract |
| GET | `/api/autofill/orders/{id}/evidence` | Dispute-grade evidence bundle |
| GET | `/api/autofill/products/search` | Search products across the vetted merchant network |
| GET | `/api/autofill/reliability` | Per-merchant success rate |
| POST | `/api/autofill/shopify/quote` | Price a cart, with shipping options, before anything is charged |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/agnic-ai/openapi/_ae-authored/agnic-ai-api-reference-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/agnic-ai/json-schema/agnic-ai-post-api-autofill-shopify-quote-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/agnic-ai/json-schema/agnic-ai-get-api-autofill-orders-id-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/agnic-ai/json-schema/agnic-ai-post-api-autofill-shopify-quote-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/agnic-ai/json-schema/agnic-ai-get-api-agent-identity-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/agnic-ai/json-schema/agnic-ai-get-api-agent-email-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/agnic-ai/json-schema/agnic-ai-post-api-agent-email-response-schema.json
- **APIsJSON** — https://artifacts.apis.io/agnic-ai/apis.yml

## Other Agnic APIs (2)

- [Agnic core API](https://apis.io/apis/agnic-ai/core-api/)
- [Agnic X402 API](https://apis.io/apis/agnic-ai/x402-api/)

---

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