UCPList Public API

Free JSON API for the UCP directory. No auth required. 100 requests/day per IP.

State of UCP data

Use the same tools and integration directory that powers State of UCP. Each record includes its source, review date, capabilities, and stable URL.

Base URL

https://ucplist.ai/api

GET /api/listings

Returns all active listings.

Query Parameters

ParamTypeDescription
categorystringFilter by category: merchants, platforms, payment-handlers, developer-tools, agent-integrations
qstringSearch by name or description

Example

curl https://ucplist.ai/api/listings?category=merchants

Response

[
  {
    "id": "allbirds",
    "name": "Allbirds",
    "slug": "allbirds",
    "category": "merchants",
    "description": "Sustainable footwear brand with a live UCP checkout endpoint.",
    "url": "https://www.allbirds.com",
    "ucpEndpoint": "https://www.allbirds.com/.well-known/ucp",
    "verifiedAt": "2026-03-04",
    "tags": ["footwear", "sustainable", "d2c"],
    "ucpStatus": "live"
  }
]

GET /api/listings/:slug

Returns a single listing by slug.

Example

curl https://ucplist.ai/api/listings/shopify

Response

{
  "id": "shopify",
  "name": "Shopify",
  "slug": "shopify",
  "category": "platforms",
  "description": "Leading e-commerce platform with native UCP checkout support.",
  "url": "https://www.shopify.com",
  "ucpEndpoint": null,
  "verifiedAt": "2026-03-04",
  "tags": ["e-commerce", "saas", "checkout", "merchant-platform"],
  "ucpStatus": "ecosystem"
}

404 Response

{ "error": "Listing not found" }

Rate Limits

100 requests per day per IP address. No API key required.

The X-RateLimit-Remaining header on each response shows how many requests you have left.

When exceeded, the API returns 429 Too Many Requests:

{ "error": "Rate limit exceeded. Get an API key for higher limits." }

Need higher limits? Contact us about API key access.

Response Fields

FieldTypeDescription
idstringUnique identifier (same as slug)
namestringDisplay name
slugstringURL-safe identifier
categorystringOne of: merchants, platforms, payment-handlers, developer-tools, agent-integrations
descriptionstringShort description
urlstringWebsite URL
ucpEndpointstring | nullDirect UCP endpoint URL, or null if not available
verifiedAtstring | nullISO date of last verification (YYYY-MM-DD)
tagsstring[]Searchable tags
ucpStatusstringOne of: live, announced, ecosystem