Skip to main content
The Discovery API provides programmatic access to the Corbits API catalog. Use it to search for proxies, list available endpoints, retrieve OpenAPI specs, and get pricing details. Base URL: https://api.corbits.dev No authentication required.

​
Key concepts

​
Proxy URLs

Each proxy has a dedicated URL constructed from its name and optional org slug:
  • https://{name}.api.corbits.dev — standard proxy
  • https://{name}.{org_slug}.api.corbits.dev — org-scoped proxy
Always use the proxy’s url field from API responses as the base URL for making calls. Do not use the discovery API URL (api.corbits.dev) for API calls.

​
Pricing

Prices are stored as micro-USDC integers. To convert to USDC, multiply by 1e-6:
price_usdc valueUSDC amount
1000$0.001
10000$0.01
1000000$1.00

​
Payment handling

The x-402 extension in OpenAPI specs indicates endpoints that require payment. If you’re making calls programmatically, use the @faremeter/rides SDK — it handles the full x402 challenge/response cycle automatically. See the Corbits Skill for a working implementation.

​
List your proxy on Discovery

Find useful solutions and let your solutions be found by others. Discovery is a two-sided marketplace — you can consume APIs listed by others, and list your own so they’re discoverable by developers and AI agents alike. Make sure your Corbits proxy is registered and active so it appears in search results.

​
Endpoints

​
Health check

GET /health
Returns 200 OK if the service is running. 
curl https://api.corbits.dev/health

​
Search proxies and endpoints

GET /api/v1/search?q=<query>
Full-text search across proxy names, descriptions, tags, and endpoint path patterns. Returns matching proxies and endpoints.
​
q
string
required
Search query. Empty or whitespace-only queries return empty results.
curl "https://api.corbits.dev/api/v1/search?q=openai"

​
List proxies

GET /api/v1/proxies
List all active API proxies. Supports cursor-based pagination.
​
cursor
integer
ID of the last item from the previous page. Omit for the first page.
​
limit
integer
default:"20"
Number of results per page. Maximum 100.
curl "https://api.corbits.dev/api/v1/proxies?limit=20"
To paginate, pass the id of the last item as cursor: 
curl "https://api.corbits.dev/api/v1/proxies?cursor=61&limit=20"

​
Get proxy details

GET /api/v1/proxies/{id}
Returns a single proxy with its endpoint_count.
​
id
integer
required
Proxy ID.
curl https://api.corbits.dev/api/v1/proxies/61
Errors: 400 invalid ID, 404 not found or inactive.

​
Get OpenAPI spec

GET /api/v1/proxies/{id}/openapi
Returns the proxy’s full OpenAPI specification, including endpoint schemas, parameters, and x-corbits-price extension fields for per-endpoint pricing.
​
id
integer
required
Proxy ID.
curl https://api.corbits.dev/api/v1/proxies/61/openapi
The servers[0].url field contains the upstream base path. When constructing call URLs, combine the proxy URL with this base path and the spec path: https://openai.api.corbits.dev/v1/models.
Errors: 400 invalid ID, 404 not found or no spec available.

​
List proxy endpoints

GET /api/v1/proxies/{id}/endpoints
List all endpoints for a proxy with pricing details. Supports cursor-based pagination.
​
id
integer
required
Proxy ID.
​
cursor
integer
ID of the last item from the previous page.
​
limit
integer
default:"20"
Number of results per page. Maximum 100.
curl https://api.corbits.dev/api/v1/proxies/61/endpoints
Errors: 404 proxy not found or inactive.

​
Get endpoint details

GET /api/v1/proxies/{id}/endpoints/{endpointId}
Returns a single endpoint’s details including pricing and description.
​
id
integer
required
Proxy ID.
​
endpointId
integer
required
Endpoint ID.
curl https://api.corbits.dev/api/v1/proxies/61/endpoints/145
Errors: 400 invalid ID, 404 not found.