Agnic

Agnic API Reference API

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.

Documentation GitHub OpenAPI

Operations 17

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 #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/agnic-ai:api-reference-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.1.0
info:
  title: Agnic API Reference API
  version: '2026-11-01'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-01: 17 operation(s) read from 2 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Agnic has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 7
    documentation: 23
    pages-with-code: 10
    pages-read: 14
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-01'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.agnic.ai/docs/api-reference/agent-email-kya.mdx
  - https://docs.agnic.ai/docs/api-reference/checkout
  x-docs-section: api-reference
servers:
- url: https://api.agnic.ai
paths:
  /api/agent/credential:
    get:
      operationId: get_api_agent_credential
      tags:
      - Api
      summary: Returns the agent's SD-JWT trust credential (used by merchants for identity verification).
      x-source: https://docs.agnic.ai/docs/api-reference/agent-email-kya.mdx
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiAgentCredentialResponse'
      x-evidence:
        kind: documentation
  /api/agent/email:
    get:
      operationId: get_api_agent_email
      tags:
      - Api
      summary: 'Returns alias info, or `{ hasEmail: false }` if not provisioned.'
      x-source: https://docs.agnic.ai/docs/api-reference/agent-email-kya.mdx
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiAgentEmailResponse'
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_agent_email
      tags:
      - Api
      summary: Creates the alias. Idempotent — re-posting with a new `displayName` updates it in place. Requires an active KYA agent.
      x-source: https://docs.agnic.ai/docs/api-reference/agent-email-kya.mdx
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiAgentEmailRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiAgentEmailResponse'
      x-evidence:
        kind: documentation
  /api/agent/email/inbox:
    get:
      operationId: get_api_agent_email_inbox
      tags:
      - Api
      summary: Returns inbound and outbound messages, newest first.
      x-source: https://docs.agnic.ai/docs/api-reference/agent-email-kya.mdx
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: default 20, max 100
      - name: offset
        in: query
        required: false
        schema:
          type: integer
        description: default 0
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiAgentEmailInboxResponse'
      x-evidence:
        kind: documentation
  /api/agent/email/reply:
    post:
      operationId: post_api_agent_email_reply
      tags:
      - Api
      summary: Replies to an inbox message. Sets `In-Reply-To`/`References` headers automatically. Marks the original as read.
      x-source: https://docs.agnic.ai/docs/api-reference/agent-email-kya.mdx
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiAgentEmailReplyRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiAgentEmailReplyResponse'
      x-evidence:
        kind: documentation
  /api/agent/email/send:
    post:
      operationId: post_api_agent_email_send
      tags:
      - Api
      summary: Sends from the agent's address. Plain text only (HTML not supported on send today).
      x-source: https://docs.agnic.ai/docs/api-reference/agent-email-kya.mdx
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiAgentEmailSendRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiAgentEmailSendResponse'
      x-evidence:
        kind: documentation
  /api/agent/identity:
    get:
      operationId: get_api_agent_identity
      tags:
      - Api
      summary: Returns the active agent's ERC-8004 identity. `agentId` is the on-chain KYA registration ID.
      x-source: https://docs.agnic.ai/docs/api-reference/agent-email-kya.mdx
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiAgentIdentityResponse'
      x-evidence:
        kind: documentation
  /api/autofill/cards:
    get:
      operationId: get_api_autofill_cards
      tags:
      - Api
      summary: The cards this user has vaulted
      x-source: https://docs.agnic.ai/docs/api-reference/checkout
      parameters:
      - name: X-Agnic-Token
        in: header
        required: true
        schema:
          type: string
        description: ApiToken OAuth2
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiAutofillCardsResponse'
      x-evidence:
        kind: documentation
  /api/autofill/explore:
    post:
      operationId: post_api_autofill_explore
      tags:
      - Api
      summary: Onboard a merchant nobody has bought from before
      x-source: https://docs.agnic.ai/docs/api-reference/checkout
      parameters:
      - name: X-Agnic-Token
        in: header
        required: true
        schema:
          type: string
        description: ApiToken OAuth2
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiAutofillExploreRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiAutofillExploreResponse'
      x-evidence:
        kind: documentation
  /api/autofill/merchants:
    get:
      operationId: get_api_autofill_merchants
      tags:
      - Api
      summary: GET /api/autofill/merchants
      x-source: https://docs.agnic.ai/docs/api-reference/checkout
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl) curl -X GET ''https://api.agnic.ai/api/autofill/merchants''  -H ''X-Agnic-Token: YOUR_TOKEN'' GET /api/autofill/merchants/{id}
          One merchant, with its catalogue when it has one Auth: ApiToken OAuth2 path parameters Name Type Description id * string Responses 200
          Merchant metadata object 401 Unauthorized - invalid or missing authentication Field Type Description error string error_description
          stri'
  /api/autofill/merchants/{id}:
    get:
      operationId: get_api_autofill_merchants_id
      tags:
      - Api
      summary: One merchant, with its catalogue when it has one
      x-source: https://docs.agnic.ai/docs/api-reference/checkout
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: X-Agnic-Token
        in: header
        required: true
        schema:
          type: string
        description: ApiToken OAuth2
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiAutofillMerchantsIdResponse'
      x-evidence:
        kind: documentation
  /api/autofill/orders:
    get:
      operationId: get_api_autofill_orders
      tags:
      - Api
      summary: Recent orders for the authenticated user
      x-source: https://docs.agnic.ai/docs/api-reference/checkout
      parameters:
      - name: X-Agnic-Token
        in: header
        required: true
        schema:
          type: string
        description: ApiToken OAuth2
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiAutofillOrdersResponse'
      x-evidence:
        kind: documentation
  /api/autofill/orders/{id}:
    get:
      operationId: get_api_autofill_orders_id
      tags:
      - Api
      summary: One order, with the failure contract
      x-source: https://docs.agnic.ai/docs/api-reference/checkout
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: X-Agnic-Token
        in: header
        required: true
        schema:
          type: string
        description: ApiToken OAuth2
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiAutofillOrdersIdResponse'
      x-evidence:
        kind: documentation
  /api/autofill/orders/{id}/evidence:
    get:
      operationId: get_api_autofill_orders_id_evidence
      tags:
      - Api
      summary: Dispute-grade evidence bundle
      x-source: https://docs.agnic.ai/docs/api-reference/checkout
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: X-Agnic-Token
        in: header
        required: true
        schema:
          type: string
        description: ApiToken OAuth2
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiAutofillOrdersIdEvidenceResponse'
      x-evidence:
        kind: documentation
  /api/autofill/products/search:
    get:
      operationId: get_api_autofill_products_search
      tags:
      - Api
      summary: Search products across the vetted merchant network
      x-source: https://docs.agnic.ai/docs/api-reference/checkout
      parameters:
      - name: X-Agnic-Token
        in: header
        required: true
        schema:
          type: string
        description: ApiToken OAuth2
      - name: q
        in: query
        required: true
        schema:
          type: string
        description: search term
      - name: country
        in: query
        required: true
        schema:
          type: string
        description: '"US" | "GB" | "CA" | "AU"'
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: default 20
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiAutofillProductsSearchResponse'
      x-evidence:
        kind: documentation
  /api/autofill/reliability:
    get:
      operationId: get_api_autofill_reliability
      tags:
      - Api
      summary: Per-merchant success rate
      x-source: https://docs.agnic.ai/docs/api-reference/checkout
      parameters:
      - name: X-Agnic-Token
        in: header
        required: true
        schema:
          type: string
        description: ApiToken OAuth2
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiAutofillReliabilityResponse'
      x-evidence:
        kind: documentation
  /api/autofill/shopify/quote:
    post:
      operationId: post_api_autofill_shopify_quote
      tags:
      - Api
      summary: Price a cart, with shipping options, before anything is charged
      x-source: https://docs.agnic.ai/docs/api-reference/checkout
      parameters:
      - name: X-Agnic-Token
        in: header
        required: true
        schema:
          type: string
        description: ApiToken OAuth2
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiAutofillShopifyQuoteRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiAutofillShopifyQuoteResponse'
      x-evidence:
        kind: documentation
security:
- bearer: []
components:
  schemas:
    GetApiAgentCredentialResponse:
      type: object
      properties:
        hasCredential:
          type: boolean
        trustCredential:
          type: string
        delegationCredential:
          type: string
        expiresAt:
          type: string
    GetApiAgentEmailResponse:
      type: object
      properties:
        hasEmail:
          type: boolean
        emailAddress:
          type: string
        displayName:
          type: string
        walletAddress:
          type: string
        agentId:
          type: integer
        isActive:
          type: boolean
        createdAt:
          type: string
    PostApiAgentEmailRequest:
      type: object
      properties:
        displayName:
          type: string
    PostApiAgentEmailResponse:
      type: object
      properties:
        hasEmail:
          type: boolean
        emailAddress:
          type: string
        displayName:
          type: string
        walletAddress:
          type: string
        agentId:
          type: integer
        isActive:
          type: boolean
        createdAt:
          type: string
    GetApiAgentEmailInboxResponse:
      type: object
      properties:
        emailAddress:
          type: string
        messages:
          type: array
          description: list of message objects
        limit:
          type: integer
        offset:
          type: integer
    PostApiAgentEmailReplyRequest:
      type: object
      properties:
        messageId:
          type: string
          description: the `id` field from the inbox
        body:
          type: string
      required:
      - messageId
      - body
    PostApiAgentEmailReplyResponse:
      type: object
      properties:
        sent:
          type: boolean
        messageId:
          type: string
        from:
          type: string
        to:
          type: string
        subject:
          type: string
    PostApiAgentEmailSendRequest:
      type: object
      properties:
        to:
          type: string
        subject:
          type: string
        body:
          type: string
      required:
      - to
      - subject
      - body
    PostApiAgentEmailSendResponse:
      type: object
      properties:
        sent:
          type: boolean
        messageId:
          type: string
        from:
          type: string
        to:
          type: string
        subject:
          type: string
    GetApiAgentIdentityResponse:
      type: object
      properties:
        hasAgent:
          type: boolean
        agentId:
          type: integer
        chainId:
          type: string
        walletAddress:
          type: string
        trustScore:
          type: integer
        status:
          type: string
        email:
          type: string
        delegation:
          type: object
    GetApiAutofillCardsResponse:
      type: object
      properties:
        cards:
          type: object
          description: array of vaulted card objects
    PostApiAutofillExploreRequest:
      type: object
      properties:
        merchant_url:
          type: string
          description: uri
        goal:
          type: string
        prefs:
          type: string
        currency:
          type: string
      required:
      - merchant_url
    PostApiAutofillExploreResponse:
      type: object
      properties:
        message:
          type: string
          description: Discovery started or completed
    GetApiAutofillMerchantsIdResponse:
      type: object
      properties:
        merchant:
          type: object
          description: merchant metadata
    GetApiAutofillOrdersResponse:
      type: object
      properties:
        orders:
          type: object
    GetApiAutofillOrdersIdResponse:
      type: object
      properties:
        id:
          type: string
        merchant_id:
          type: string
        status:
          type: string
        amount_minor:
          type: integer
        amount_charged_minor:
          type: integer
        currency:
          type: string
        retryable:
          type: boolean
        retry_action:
          type: string
        error_code:
          type: string
        error_message:
          type: string
        ship_to:
          type: object
        constraints:
          type: object
        test:
          type: boolean
        evidence:
          type: object
    GetApiAutofillOrdersIdEvidenceResponse:
      type: object
      properties:
        evidence:
          type: object
    GetApiAutofillProductsSearchResponse:
      type: object
      properties:
        query:
          type: string
        country:
          type: string
        currency:
          type: string
        shops_searched:
          type: integer
        chunks:
          type: integer
        price_note:
          type: string
        products:
          type: object
    GetApiAutofillReliabilityResponse:
      type: object
      properties:
        reliability:
          type: object
    PostApiAutofillShopifyQuoteRequest:
      type: object
      properties:
        merchant_id:
          type: string
        items:
          type: object
          description: array of items
        sku:
          type: string
        quantity:
          type: integer
        fulfillment_option_id:
          type: string
        pickup_location:
          type: string
        pickup_location_id:
          type: string
        ship_to:
          type: object
        constraints:
          type: object
          description: spending limits
      required:
      - merchant_id
      - items
      - sku
    PostApiAutofillShopifyQuoteResponse:
      type: object
      properties:
        rail:
          type: string
        fulfillment_options:
          type: object
        title:
          type: string
        description:
          type: string
        price_minor:
          type: integer
        currency:
          type: string
        requires_address:
          type: boolean
        requires_fulfillment_choice:
          type: boolean
        selected_option_id:
          type: string
        expected_amount_minor:
          type: integer
        amount_is_final:
          type: boolean
        subtotal_minor:
          type: integer
        charge_estimate_minor:
          type: integer
        charge_cap_minor:
          type: integer
        basket_url:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
tags:
- name: Api