---
title: "Coverage Cat OpenAPI and Discovery Docs"
description: "Coverage Cat OpenAPI and discovery docs covering shopper-safe consumer and delegated JSON discovery entry points, YAML and JSON contracts, markdown mirrors, and related llms.txt files."
canonical: "https://www.coveragecat.com/developers/openapi"
last-updated: "2026-11-17"
---

# Coverage Cat OpenAPI and Discovery Docs

## Coverage Cat API discovery URLs

- `/api/consumer`: shopper-agent discovery JSON
- `/api/consumer.md`: markdown mirror of the consumer discovery document
- `/api/consumer/openapi.yaml`: shopper-safe consumer OpenAPI YAML
- `/api/consumer/openapi.yaml.md`: markdown mirror of the consumer OpenAPI download path
- `/api/consumer/openapi.json`: shopper-safe consumer OpenAPI JSON
- `/api/agent`: delegated/operator discovery JSON
- `/api/agent.md`: markdown mirror of the delegated discovery document
- `/api/agent/openapi.yaml`: delegated/operator OpenAPI YAML
- `/api/agent/openapi.yaml.md`: markdown mirror of the delegated OpenAPI download path
- `/openapi.json`: full public OpenAPI JSON superset
- `/api/openapi.yaml`: predictable YAML alias
- `/agent-plugin/plugin.json`: packaged Agent Plugin manifest

## What the Coverage Cat contract covers

- Shopper-safe consumer umbrella prefill/direct-follow-up flows
- Delegated umbrella purchase workflow
- Read-only calculators
- Auth endpoints for operator-key issuance and rotation
- Sandbox and rehearsal semantics
- Explicit `Coverage-Cat-API-Version` and `Idempotency-Key` headers on the agent-operable surface, plus consumer idempotency on direct follow-up writes

## Related Coverage Cat metadata

- `/.well-known/api-catalog`
- `/.well-known/agent-skills/index.json`
- `/.well-known/ai-catalog.json`
- `/api/llms.txt`
- `/.well-known/mcp.json`

## Preferred order

1. If you are building a shopper-facing flow, start with `/api/consumer` or `/.well-known/mcp.json`.
2. Fetch `/api/consumer/openapi.yaml` or `/api/consumer/openapi.json`.
3. Only when you need operator-authenticated delegated tools, read `/api/agent` and `/api/agent/openapi.yaml`.
4. Pin the delegated contract with `Coverage-Cat-API-Version: v1` when you want an explicit stable version.
5. Read the relevant runtime markdown skill or packaged plugin manifest.
6. Use `/developers/auth` before live delegated traffic, and use `/developers/data-handling` plus `/developers/sandbox` before live consumer or delegated traffic.

## Multi-language starter samples

Coverage Cat's shopper-safe consumer discovery document is the fastest starting point for a personal shopping agent. From there, call the consumer-prefill flow instead of sending the shopper straight to `/umbrella`.

```sh
curl https://www.coveragecat.com/api/consumer
curl -X POST https://www.coveragecat.com/api/consumer/umbrella/prefill \
  -H "Content-Type: application/json" \
  -H "Coverage-Cat-API-Version: v1" \
  -H "Idempotency-Key: demo-consumer-prefill-1" \
  -d '{"credit_consent_pending":true,"intake":{"full_name":"Taylor Example","email":"taylor@example.test","address":{"street":"123 Main St","city":"San Francisco","state":"CA","zip":"94107"}}}'
```

```javascript
const discovery = await fetch("https://www.coveragecat.com/api/consumer").then((response) => response.json());
console.log(discovery.preferred_openapi_url);
```

```python
import requests

discovery = requests.get("https://www.coveragecat.com/api/consumer", timeout=30).json()
print(discovery["preferred_openapi_url"])
```
