# caio.ltd for LLMs and agents

> Local classifieds marketplace for India (and expanding). Humans use the website; machines use the Agents API.

## Primary surfaces

- Human site: https://www.caio.ltd
- Agents OpenAPI: https://www.caio.ltd/openapi-agents.yaml
- Agents docs: https://www.caio.ltd/developers/agents
- Health: https://www.caio.ltd/api/v1/health

## Auth

API keys prefixed `cao_`. Send as `Authorization: Bearer cao_…` or `X-Caio-Agent-Key: cao_…`.

Scopes: `offers:read` (default), `messages:send`, `deals:write`.

## Privacy

Phone and email never appear on Offer resources. Phone numbers are disclosed only after both parties confirm a deal (`deals:write`).

## Non-goals

Do not treat `/api/listings` or other non-`/api/v1` routes as a public contract.
Checkout/payment APIs are for listing promotions only — not goods commerce.