Agnic core API

openapi: 3.1.0
info:
  title: Agnic core API
  version: '2026-11-01'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-01: 10 operation(s) read from 4 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/agentic-commerce/checkout-api
  - https://docs.agnic.ai/docs/partner-program/checkout
  - https://docs.agnic.ai/docs/quickstart
  - https://docs.payai.network/x402/reference
  x-docs-section: core
servers:
- url: https://api.agnic.ai
paths:
  /api/autofill/dispatch:
    post:
      operationId: post_api_autofill_dispatch
      tags:
      - Api
      summary: POST /api/autofill/dispatch never sees a token.
      x-source: https://docs.agnic.ai/docs/agentic-commerce/checkout-api
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiAutofillDispatchResponse'
      x-evidence:
        kind: documentation
  /dispatch:
    post:
      operationId: post_dispatch
      tags:
      - Dispatch
      summary: POST /dispatch will place an order for a caller with no mandate on file.
      x-source: https://docs.agnic.ai/docs/agentic-commerce/checkout-api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostDispatchRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostDispatchResponse'
      x-evidence:
        kind: documentation
  /api/balance:
    get:
      operationId: get_api_balance
      tags:
      - Api
      summary: GET /api/balance
      x-source: https://docs.agnic.ai/docs/quickstart
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiBalanceResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://api.agnic.ai/api/balance  -H \"X-Agnic-Token: agnic_tok_YOUR_TOKEN\" \n Response: \n { \n \"usdcBalance\" : \"\
          4.950000\" , \n \"address\" : \"0x1234...\" , \n \"hasWallet\" : true , \n \"network\" : \"base-sepolia\" \n } \n Using with OpenAI\
          \ SDK \n Python \n from openai import OpenAI \n client = OpenAI( \n api_key = \"agnic_tok_YOUR_TOKEN\" , \n base_url = \"https://api.agnic.ai/v1\"\
          \ \n ) \n response = client.chat.comp"
  /api/x402/fetch:
    post:
      operationId: post_api_x402_fetch
      tags:
      - Api
      summary: POST /api/x402/fetch
      x-source: https://docs.agnic.ai/docs/quickstart
      parameters:
      - name: url
        in: query
        required: false
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiX402FetchRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiX402FetchResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST \"https://api.agnic.ai/api/x402/fetch?url=https://api.example.com/data\"  -H \"X-Agnic-Token: agnic_tok_YOUR_TOKEN\"\
          \  -H \"Content-Type: application/json\"  -d '{\"prompt\": \"Generate a summary\"}' \n X402 Payments is an opt-in feature. If you haven't\
          \ already, enable it under Settings → Credits → Enable X402 Payments in the dashboard. It's a one-time step. \n Step 4: Check Your Balance "
  /discovery/resources:
    get:
      operationId: get_discovery_resources
      tags:
      - Discovery
      summary: List discoverable x402 resources from the Bazaar.
      x-source: https://docs.payai.network/x402/reference
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: Maximum number of results to return (1-1000).
      - name: offset
        in: query
        required: false
        schema:
          type: integer
        description: Number of results to skip for pagination.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetDiscoveryResourcesResponse'
      x-evidence:
        kind: documentation
  /settle:
    post:
      operationId: post_settle
      tags:
      - Settle
      summary: Settles a payment by broadcasting the transaction to the blockchain.
      x-source: https://docs.payai.network/x402/reference
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostSettleRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostSettleResponse'
      x-evidence:
        kind: documentation
  /supported:
    get:
      operationId: get_supported
      tags:
      - Supported
      summary: Returns the list of payment schemes and networks supported by the facilitator.
      x-source: https://docs.payai.network/x402/reference
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSupportedResponse'
      x-evidence:
        kind: documentation
  /v1/chat/completions:
    post:
      operationId: post_v1_chat_completions
      tags:
      - Chat
      summary: POST /v1/chat/completions
      x-source: https://docs.agnic.ai/docs/quickstart
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1ChatCompletionsRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1ChatCompletionsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://api.agnic.ai/v1/chat/completions  -H \"X-Agnic-Token: agnic_tok_YOUR_TOKEN\"  -H \"Content-Type: application/json\"\
          \  -d '{ \n \"model\": \"openai/gpt-4o-mini\", \n \"messages\": [{\"role\": \"user\", \"content\": \"Hello!\"}] \n }' \n Using the X402\
          \ Fetch Proxy \n For any X402-enabled API, use our transparent proxy: "
  /verify:
    post:
      operationId: post_verify
      tags:
      - Verify
      summary: Verifies a payment authorization without executing the transaction on the blockchain.
      x-source: https://docs.payai.network/x402/reference
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostVerifyRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostVerifyResponse'
      x-evidence:
        kind: documentation
  /topup:
    get:
      operationId: get_topup
      tags:
      - Topup
      summary: Partner-Branded Checkout
      x-source: https://docs.agnic.ai/docs/partner-program/checkout
      parameters:
      - name: client_id
        in: query
        required: true
        schema:
          type: string
        description: Your app client id. Must be approved and not revoked.
      - name: return_url
        in: query
        required: true
        schema:
          type: string
        description: Absolute URL, URL‑encoded. Must match one of the client's registered redirect_uris.
      - name: amount
        in: query
        required: false
        schema:
          type: string
        description: Preset (in cents) to pre‑select. If matches a package exactly, that chip is highlighted.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
security:
- bearer: []
components:
  schemas:
    PostApiAutofillDispatchResponse:
      type: object
      properties:
        '409':
          type: string
          description: Returned when a spending cap is breached or when the total came out above the amount you authorised (price_changed).
    GetApiBalanceResponse:
      type: object
      properties:
        usdcBalance:
          type: string
        address:
          type: string
        hasWallet:
          type: boolean
        network:
          type: string
    PostApiX402FetchRequest:
      type: object
      properties:
        prompt:
          type: string
    PostApiX402FetchResponse:
      type: object
      properties:
        usdcBalance:
          type: string
        address:
          type: string
        hasWallet:
          type: boolean
        network:
          type: string
    GetDiscoveryResourcesResponse:
      type: object
      properties:
        x402Version:
          type: integer
          description: Protocol version.
        items:
          type: array
          description: Array of discovered resource objects.
        pagination:
          type: object
          description: Pagination info with limit, offset, total.
    PostDispatchRequest:
      type: object
      properties:
        confirmation_token:
          type: string
          description: Token returned by preview_order that binds the order details.
        user_reply:
          type: string
          description: The literal affirmative reply from the user.
        timestamp:
          type: string
          description: ISO‑8601 timestamp of the request.
        ship_to:
          type: object
          description: Delivery address when shipping to someone other than the cardholder.
        constraints:
          type: object
          description: 'Spending limits, e.g. { "max_total_minor": number, "max_shipping_minor": number }.'
      required:
      - confirmation_token
      - user_reply
      - timestamp
    PostDispatchResponse:
      type: object
      properties:
        '202':
          type: string
          description: 'Order requires approval. Returns fields: approval_required, approval_token, approval_url, expires_in, reason.'
    PostSettleRequest:
      type: object
      properties:
        paymentPayload:
          type: object
          description: Payment payload containing version, accepted payment details and proof.
        paymentRequirements:
          type: object
          description: Original payment requirements used for settlement.
      required:
      - paymentPayload
      - paymentRequirements
    PostSettleResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Indicates whether settlement succeeded.
        payer:
          type: string
          description: Address of the payer.
        transaction:
          type: string
          description: Transaction identifier (empty on error).
        network:
          type: string
          description: Blockchain network identifier.
        errorReason:
          type: string
          description: Reason for failure (present only on error).
    GetSupportedResponse:
      type: object
      properties:
        kinds:
          type: array
          description: Array of supported scheme/network objects.
        extensions:
          type: array
          description: Optional extensions.
        signers:
          type: object
          description: Signer information.
    PostV1ChatCompletionsRequest:
      type: object
      properties:
        model:
          type: string
        messages:
          type: array
          items:
            type: object
            properties:
              role:
                type: string
              content:
                type: string
    PostV1ChatCompletionsResponse:
      type: object
      properties:
        usdcBalance:
          type: string
        address:
          type: string
        hasWallet:
          type: boolean
        network:
          type: string
    PostVerifyRequest:
      type: object
      properties:
        paymentPayload:
          type: object
          description: Payment payload containing version, accepted payment details and proof.
        paymentRequirements:
          type: object
          description: Original payment requirements used for verification.
      required:
      - paymentPayload
      - paymentRequirements
    PostVerifyResponse:
      type: object
      properties:
        isValid:
          type: boolean
          description: Indicates whether the payment payload is valid.
        payer:
          type: string
          description: Address of the payer.
        invalidReason:
          type: string
          description: Reason for invalidity (present only on error).
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
tags:
- name: Api
- name: Chat
- name: Discovery
- name: Dispatch
- name: Settle
- name: Supported
- name: Topup
- name: Verify