FieldRobin

FieldRobin Agent Commerce API

The Agent Commerce API from FieldRobin — 5 operation(s) for agent commerce.

GitHub OpenAPI

Operations 6

GET /v1/agent Describe public agent commerce surfaces #
GET /v1/agent/paid-reference Retrieve a paid agent content reference #
GET /v1/agent/a2a Return the FieldRobin A2A Agent Card #
POST /v1/agent/a2a Handle a minimal A2A message/send request #
GET /v1/agent/ucp Return the UCP REST service entry point #
POST /v1/agent/ucp/checkout Start a UCP content checkout handoff #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/fieldrobin-com/openapi/fieldrobin-com-agent-commerce-api-openapi.yml

Other Resources

🔗
APIsJSON
https://artifacts.apis.io/fieldrobin-com/apis.yml

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/fieldrobin-com:fieldrobin-com-agent-commerce-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

fieldrobin-com-agent-commerce-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: FieldRobin Public Agent Commerce API
  version: 1.0.0
  description: 'Public, unauthenticated content and agent-commerce endpoints for FieldRobin.


    Authenticated application, account, administrative, webhook, and tokenized endpoints are intentionally excluded.'
  contact:
    name: FieldRobin Support
    email: support@fieldrobin.dev
servers:
- url: https://fieldrobin.com/api
  description: FieldRobin public API
tags:
- name: Agent Commerce
paths:
  /v1/agent:
    get:
      tags:
      - Agent Commerce
      summary: Describe public agent commerce surfaces
      operationId: getAgentCommerceDiscovery
      security: []
      responses:
        '200':
          description: Agent commerce discovery links and protocol documents
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
  /v1/agent/paid-reference:
    get:
      tags:
      - Agent Commerce
      summary: Retrieve a paid agent content reference
      description: 'Protected with x402. An unpaid request returns HTTP 402 with payment

        requirements. A successful payment returns the agent resource.'
      operationId: getPaidAgentReference
      security: []
      x-payment-info:
        intent: charge
        method: tempo
        amount: '1'
        currency: USD
        description: One paid FieldRobin agent content reference.
      responses:
        '200':
          description: Paid agent content reference
          content:
            application/json:
              schema:
                type: object
                required:
                - resource
                - content
                - protocol
                properties:
                  resource:
                    type: string
                  content:
                    type: string
                  protocol:
                    type: string
                    example: x402
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '503':
          description: x402 wallet or facilitator configuration is missing
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
  /v1/agent/a2a:
    get:
      tags:
      - Agent Commerce
      summary: Return the FieldRobin A2A Agent Card
      operationId: getAgentCommerceCard
      security: []
      responses:
        '200':
          description: A2A Agent Card
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
    post:
      tags:
      - Agent Commerce
      summary: Handle a minimal A2A message/send request
      operationId: sendAgentCommerceMessage
      security: []
      parameters:
      - $ref: '#/components/parameters/IdempotencyKeyHeader'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - jsonrpc
              - id
              - method
              properties:
                jsonrpc:
                  type: string
                  enum:
                  - '2.0'
                id:
                  oneOf:
                  - type: string
                  - type: integer
                  - type: 'null'
                method:
                  type: string
                  enum:
                  - message/send
      responses:
        '200':
          description: JSON-RPC task response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
        '400':
          description: Invalid Idempotency-Key header or JSON-RPC request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
  /v1/agent/ucp:
    get:
      tags:
      - Agent Commerce
      summary: Return the UCP REST service entry point
      operationId: getUcpAgentService
      security: []
      responses:
        '200':
          description: UCP service profile
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
  /v1/agent/ucp/checkout:
    post:
      tags:
      - Agent Commerce
      summary: Start a UCP content checkout handoff
      description: Returns a UCP checkout session that hands payment to the protected resource.
      operationId: createUcpAgentCheckout
      security: []
      parameters:
      - $ref: '#/components/parameters/IdempotencyKeyHeader'
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        '200':
          description: UCP checkout handoff
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
        '400':
          description: Invalid Idempotency-Key header
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
components:
  parameters:
    IdempotencyKeyHeader:
      name: Idempotency-Key
      in: header
      required: false
      description: 'Optional opaque key for safe retries. Reusing the same key with an equivalent request replays the original response and includes `Idempotency-Replayed: true`; using it with a different request returns `409 IDEMPOTENCY_KEY_REUSED`. Maximum 128 visible ASCII characters.'
      schema:
        type: string
        minLength: 1
        maxLength: 128
  schemas:
    ErrorMessage:
      type: object
      required:
      - code
      - message
      - resolution
      - status
      properties:
        code:
          type: string
          example: RESOURCE_NOT_FOUND
        message:
          type: string
          example: The given data was invalid.
        resolution:
          type: string
          example: Verify the identifier and try again.
        status:
          type: integer
          example: 404
  responses:
    PaymentRequired:
      description: Payment is required before the resource can be returned.
      headers:
        Payment-Required:
          description: Protocol-specific payment requirements.
          schema:
            type: string
      content:
        application/json:
          schema:
            type: object
            additionalProperties: true
x-service-info:
  categories:
  - field-service
  - agent-commerce
  - payments
  docs:
    homepage: https://fieldrobin.com/docs
    llms: https://fieldrobin.com/llms.txt
    apiReference: https://fieldrobin.com/openapi.json
  discovery:
    acp: https://fieldrobin.com/.well-known/acp.json
    ucp: https://fieldrobin.com/.well-known/ucp
    a2a: https://fieldrobin.com/.well-known/agent.json
  integrations:
    mcp:
      endpoint: https://fieldrobin.com/api/v1/mcp
      serverCard: https://fieldrobin.com/.well-known/mcp/server-card.json
      authorizationServerMetadata: https://fieldrobin.com/.well-known/oauth-authorization-server
      protectedResourceMetadata: https://fieldrobin.com/.well-known/oauth-protected-resource