Private BetaFound a bug or have feedback? Share it →
Docs / REST API

REST API Quick-Start

Direct HTTP access to all APIs from any language or HTTP client. No SDK required.

Base URL

https://api.apiclearinghouse.com

All endpoints require HTTPS. HTTP redirects to HTTPS automatically.

Authentication

All proxy calls require an API key (chk_live_...). Get your key from the dashboard.

Option 1 — X-Api-Key header (recommended)

curl -s "https://api.apiclearinghouse.com/v1/call/weather/current?lat=48.85&lon=2.35" \
  -H "X-Api-Key: chk_live_YOUR_KEY"

Option 2 — Bearer token

curl -s "https://api.apiclearinghouse.com/v1/call/weather/current?lat=48.85&lon=2.35" \
  -H "Authorization: Bearer chk_live_YOUR_KEY"

Both auth methods accept clearinghouse API keys directly. Bearer tokens are also accepted for session JWTs from POST /v1/auth/login.

Making API calls

All API proxy requests go through /v1/call/{api-slug}/{endpoint}. Query parameters are forwarded to the upstream API.

ExampleWhat it calls
/v1/call/weather/current?lat=48.85&lon=2.35Current weather in Paris
/v1/call/crypto-prices/price?symbol=BTCLive Bitcoin price
/v1/call/geocoding/search?q=BerlinGeocode "Berlin"
/v1/call/public-holidays/holidays/2025/DEGerman public holidays 2025

Browse available APIs

The catalog endpoint is public — no auth required. Returns all active APIs with endpoints, parameters, and health scores.

curl -s "https://api.apiclearinghouse.com/v1/catalog"

Or browse the full API catalog in the UI.

OpenAPI / Swagger spec

A full OpenAPI 3.1 spec is available for SDK generation, Postman import, or any OpenAPI-compatible toolchain.

View OpenAPI spec →

Import into Postman: Import → Link → paste the URL above

Error format

All errors return a consistent JSON envelope with a machine-readable code and an agent-friendly hint:

{
  "status": "error",
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded",
    "hint": "Upgrade your plan for higher limits.",
    "docs": "https://apiclearinghouse.com/docs"
  }
}