# Hatcel API

> The Hatcel API reads a Hatcel venue workspace - venues, customers, bookings, orders, products, events and gift cards - and writes its customers, tags and lists. JSON over HTTPS at https://api.hatcel.com, authenticated with a bearer API key, server to server only.

Every page below is also in one file: https://developers.hatcel.com/llms-full.txt. The OpenAPI 3.1 document is https://developers.hatcel.com/openapi.json.

## Get started
- [Introduction](https://developers.hatcel.com): What the Hatcel API is and how it works
- [Quickstart](https://developers.hatcel.com/quickstart): Make a key and send your first request
- [Authentication](https://developers.hatcel.com/authentication): Send your API key as a bearer token
- [Security](https://developers.hatcel.com/security): How the Hatcel API protects your venue's data
- [API keys](https://developers.hatcel.com/keys): Live or test, read only or read and write
- [Test data](https://developers.hatcel.com/test-data): Build against data that never touches real records

## AI agents
- [Connect an AI agent](https://developers.hatcel.com/ai-agents): Give an AI agent safe access to your workspace
- [Prompts](https://developers.hatcel.com/ai-prompts): Ready prompts to paste into your agent

## Using the API
- [Errors](https://developers.hatcel.com/errors): Every refusal, its status and its code
- [Rate limits](https://developers.hatcel.com/rate-limits): What each key and workspace may send
- [Pagination and sync](https://developers.hatcel.com/pagination): Cursor pages, and incremental sync with updated_since
- [Versioning](https://developers.hatcel.com/versioning): Pin the shape you built against
- [IDs, money and time](https://developers.hatcel.com/ids-money-time): How identifiers, amounts and instants are written
- [Idempotency](https://developers.hatcel.com/idempotency): Retry a write safely with an Idempotency-Key

## API reference
- [API key](https://developers.hatcel.com/reference/key): The calling key's limits and reach
- [Venues](https://developers.hatcel.com/reference/venues): List and retrieve venues
- [Customers](https://developers.hatcel.com/reference/customers): List, retrieve, create, update and delete customers
- [Tags](https://developers.hatcel.com/reference/tags): List and retrieve tags
- [Lists](https://developers.hatcel.com/reference/lists): List and retrieve lists
- [Bookings](https://developers.hatcel.com/reference/bookings): List and retrieve bookings
- [Orders](https://developers.hatcel.com/reference/orders): List and retrieve orders
- [Activities](https://developers.hatcel.com/reference/activities): List and retrieve activities
- [Packages](https://developers.hatcel.com/reference/packages): List and retrieve packages
- [Events](https://developers.hatcel.com/reference/events): List and retrieve events
- [Tickets](https://developers.hatcel.com/reference/tickets): List and retrieve tickets
- [Gift cards](https://developers.hatcel.com/reference/gift-cards): List and retrieve gift cards

## Optional
- [Webhooks](https://developers.hatcel.com/webhooks): Signed deliveries when something changes (coming soon)
- [Events](https://developers.hatcel.com/events): A log of changes you can replay (coming soon)

## Legal
- [API terms](https://developers.hatcel.com/api-terms): The terms for using the Hatcel API
- [Acceptable use](https://developers.hatcel.com/acceptable-use): What a key may and may not do
- [Data and privacy](https://developers.hatcel.com/data-and-privacy): Who answers for data once it leaves Hatcel