One request, end to end
Here is the whole shape of the API in a single exchange: an API key in theAuthorization header, a date in the Quo-Api-Version header, JSON back.
The API at a glance
| Base URL | https://api.quo.com |
| Authentication | API key in the Authorization header. Details |
| Versioning | Quo-Api-Version: 2026-03-30 header, required on every request. How versioning works |
| Format | JSON in, JSON out. Single resources arrive wrapped in data; lists add nextCursor. |
| Pagination | Cursor-based: limit (1–50, default 10) and after. Making requests |
| Rate limit | 10 requests per second per API key. Rate limits |
| Errors | A structured envelope that names the field at fault and can include a trace id for support. Errors |
How it’s designed
Three rules shape everything here. Versions never change after they ship. New endpoints and new optional fields land inside the current version. Anything that would break existing integrations gets a new dated version, and you upgrade when you choose to. The full contract fits on one page. Errors name the field at fault. Every error tells you what went wrong and points to the offending field. When a response includes atrace id, support can use it to find your exact request in our logs.
The docs serve people and machines. These pages, the OpenAPI spec, and the LLM-ready formats describe one contract. An agent and a human reading them reach the same understanding.
What’s available today
This version is new, and we’d rather show you a precise map than a generous one.| Surface | Status |
|---|---|
| Users | Available. List and retrieve workspace users. |
| Calls, transcripts & summaries | In development |
| Contacts | In development |
| Conversations & messages | In progress. Mark a conversation as read and retry a failed message are live; more endpoints are in development. |
| Phone numbers | In development |
Need messaging, calls, or contacts today? The v1 API remains fully supported. Switch versions with the selector in the top navigation; new capability ships here.
Where to next
Make your first request
From API key to a
200 in about two minutes.Versioning
What a dated version guarantees, and why it’s in a header.
Making requests
Headers, envelopes, ids, timestamps, and pagination.
Build with AI & agents
MCP, llms.txt, and the spec. Quo for software that reads.