# API reference

Every Kelly API operation and Kelly Wire topic, with the base URL, headers and downloads in one place.

## Basics
| What | Where |
| --- | --- |
| Base URL | `https://api.askkelly.ai` |
| Authentication | `Authorization: Bearer $KELLY_API_KEY` ([authentication](/concepts/authentication)) |
| Versioning | `Api-Version: YYYY-MM-DD`; omitted means `2026-10-05` ([conventions](/concepts/conventions#versions)) |
| Kelly Wire | `wss://wire.askkelly.ai/v1` ([streaming](/concepts/streaming)) |
| API definition | [OpenAPI 3.2.0, version 2026-10-05](/openapi/2026-10-05.json) |
| Wire definition | [AsyncAPI 3.1.0, version 2026-10-05](/asyncapi/2026-10-05.json) |
| Request collection | [Postman collection](/kelly.postman_collection.json) |
| Generator | askkelly-devdocs 0.1.0, built from API version 2026-10-05 |

## Groups
- [status](/reference/status): Check that the API answers and see who it thinks you are and what you have left.
- [reference](/reference/reference): Look up sourced, dated rules, laws, tax, operator policies, terms and help.
- [answers](/reference/answers): Ask a question in words and get a sourced answer, and the method behind any number.
- [Kelly Wire](/reference/wire): Kelly Wire: the live socket, tickets and single-topic streams.
- [Wire topics](/reference/wire-topics): Every topic Kelly Wire defines and the messages each sends.
- [Errors](/problems): One page per error code: what it means, how to fix it and whether to retry.

## All operations
| Method | Path | Title | Status | Group |
| --- | --- | --- | --- | --- |
| GET | [`/health`](/reference/status#get-health) | Check that the service answers | live | status |
| GET | [`/v1/status`](/reference/status#get-status) | See who is calling and what is left | live | status |
| GET | [`/v1/reference`](/reference/reference#list-reference) | Search published reference entries | live | reference |
| GET | [`/v1/reference/{topic_id}`](/reference/reference#get-reference) | Get a published reference entry | live | reference |
| POST | [`/v1/wire/tickets`](/reference/wire#get-wire-ticket) | Get a Kelly Wire ticket | live | Kelly Wire |
| GET | [`/v1/stream/{topic}`](/reference/wire#stream-topic) | Stream one topic as server-sent events | live | Kelly Wire |
| POST | [`/v1/answers`](/reference/answers#create-answer) | Ask a question | live | answers |

Generated from Kelly API 2026-10-05.

---

Generated from Kelly API 2026-10-05

Support: support@askkelly.ai · Security and disclosure: https://docs.askkelly.ai/security

Information is the edge. Odds are information, not advice · 21+ · Get help