API Overview

All endpoints use https://api.kubbi.ai as the base URL. Requests and responses use JSON. All /api/v1/* responses include the header API-Version: v1.

Sections

Authentication: API keys for producers and capability-URL access for consumers
Endpoints: every producer and consumer route, one page per resource
Errors: response envelope and the full error code reference
Rate limits: per-key request limits and plan-tier behaviour

Health check

GET/health

Liveness and readiness check. Verifies application and database connectivity.

Auth: None

Response 200· json

{
  "status": "ok",
  "database": "connected",
  "timestamp": "2026-03-28T12:00:00.000Z"
}

Response 503· json

{
  "status": "degraded",
  "database": "unreachable",
  "timestamp": "2026-03-28T12:00:00.000Z"
}