API Documentation

Query this registry programmatically to discover UCP/ACP merchants for your agent

Base URL

https://checkout.directory

Endpoints

List and search merchants

GET /api/merchants

Query Parameters:

qSearch by name, domain, or category

categoryFilter by category (e.g., "Footwear", "Fashion")

protocolFilter by protocol support (UCP)

Examples:

GET /api/merchants?category=Footwear

GET /api/merchants?q=allbirds

GET /api/merchants?protocol=UCP

Response:

[
  {
    "id": 8,
    "name": "Allbirds",
    "domain": "allbirds.com",
    "category": "Footwear",
    "website": "allbirds.com",
    "hasUCP": true,
    "ucpCapabilities": [
      "dev.ucp.shopping.checkout",
      "dev.ucp.shopping.fulfillment"
    ],
    "paymentHandlers": ["com.google.pay"]
  }
]

Get merchant by domain

GET /api/merchants/:domain

Path Parameters:

domainMerchant domain (e.g., "allbirds.com")

Example:

GET /api/merchants/allbirds.com

Response:

{
  "id": 8,
  "name": "Allbirds",
  "domain": "allbirds.com",
  "category": "Footwear",
  "website": "allbirds.com",
  "hasUCP": true,
  "ucpCapabilities": [
    "dev.ucp.shopping.checkout",
    "dev.ucp.shopping.fulfillment"
  ],
  "paymentHandlers": ["com.google.pay"]
}

Get merchant UCP manifest

GET /api/merchants/:domain/manifest

Path Parameters:

domainMerchant domain (e.g., "allbirds.com")

Example:

GET /api/merchants/allbirds.com/manifest

Response:

{
  "ucp": {
    "version": "2026-01-11",
    "services": {
      "dev.ucp.shopping": {
        "version": "2026-01-11",
        "spec": "https://ucp.dev/specs/shopping",
        "mcp": {
          "schema": "...",
          "endpoint": "http://allbirds.com/api/ucp/mcp"
        }
      }
    },
    "capabilities": [
      {
        "name": "dev.ucp.shopping.checkout",
        "version": "2026-01-11"
      }
    ]
  },
  "payment": {
    "handlers": [...]
  }
}

Get agent skill prompt

GET /api/skill

Returns a plain text skill prompt that agents can use to understand how to interact with this directory.

Response:

Content-Type: text/plain

---
name: checkout-directory
description: Discover merchants supporting agentic commerce protocols
---

# Checkout Directory

Use this skill to find merchants that support agentic checkout protocols.

## API Endpoints
...

Error Responses

When a resource is not found, the API returns a 404 status with an error message:

{
  "error": "Merchant not found"
}