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/apiGET /api/listings
Returns all active listings.
Query Parameters
| Param | Type | Description |
|---|---|---|
| category | string | Filter by category: merchants, platforms, payment-handlers, developer-tools, agent-integrations |
| q | string | Search by name or description |
Example
curl https://ucplist.ai/api/listings?category=merchantsResponse
[
{
"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/shopifyResponse
{
"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
| Field | Type | Description |
|---|---|---|
| id | string | Unique identifier (same as slug) |
| name | string | Display name |
| slug | string | URL-safe identifier |
| category | string | One of: merchants, platforms, payment-handlers, developer-tools, agent-integrations |
| description | string | Short description |
| url | string | Website URL |
| ucpEndpoint | string | null | Direct UCP endpoint URL, or null if not available |
| verifiedAt | string | null | ISO date of last verification (YYYY-MM-DD) |
| tags | string[] | Searchable tags |
| ucpStatus | string | One of: live, announced, ecosystem |