Overview
Public, read-only endpoints for the catalogue and demand board, plus feeds for agents.
The catalogue and the demand board are readable by code and agents from day one. Public endpoints need no key; endpoints that act for a lab need an API key.
Base URL
https://quarrydata.ai/api/v1
Resources
| Resource | Path | Access |
|---|---|---|
| OpenAPI 3.1 spec | /openapi.json | Public |
| Catalogue | GET /api/v1/catalog, GET /api/v1/catalog/{id} | Public listing fields only; NDA fields need a key |
| Demand | GET /api/v1/demand | Public |
| Requests | POST /api/v1/requests | API key (verified labs) |
| Samples | POST /api/v1/samples/{id} | API key and an accepted NDA |
| MCP server | /mcp | See MCP server |
| Static feeds | /catalog.json, /demand.json | Public, regenerated on change |
| LLM guides | /llms.txt, /llms-full.txt | Public |
Conventions
- JSON in and out, UTF-8. Fields are
snake_case. - Lists return
{"data": [...], "count": n}; a single item returns{"data": {...}}. - Errors return
{"error": {"code": "...", "message": "..."}}with an HTTP status.
{ "error": { "code": "not_found", "message": "No listing with id QD-0000." } }
Quick start
curl https://quarrydata.ai/api/v1/catalog?vertical=conversational_audio
Next: Authentication.