# Tablelist API Documentation

> Documentation for Tablelist API

Append .md to any documentation page URL to get its markdown version.

## Guides
- [Getting Started](https://api-docs.tablelistpro.com/docs/getting-started.md): Welcome to the TablelistPro Developer Docs—base URL, authentication, and your first request.
- [Rate Limits](https://api-docs.tablelistpro.com/docs/rate-limits.md): Public and partners APIs are throttled to 20 requests per second per API key, with 429 and rate-limit headers when exceeded.
- [POS](https://api-docs.tablelistpro.com/docs/pos-bulk-sync-reservations.md): Append table receipts and POS tickets (including ticket payments) to existing reservations via public bulk endpoints.
- [Webhooks](https://api-docs.tablelistpro.com/docs/webhooks.md): Configure webhooks and understand event payloads from TablelistPro.

## API Reference
- [Ping](https://api-docs.tablelistpro.com/reference/ping-1.md): Test your API key using this endpoint.
- [List customers](https://api-docs.tablelistpro.com/reference/listcustomers.md)
- [Update customer receipt](https://api-docs.tablelistpro.com/reference/updatecustomerreceipt.md): Update a manual customer receipt by id.
- [Create customer receipt](https://api-docs.tablelistpro.com/reference/createcustomerreceipt.md): Create a manual customer receipt.
- [List venues](https://api-docs.tablelistpro.com/reference/listvenues.md)
- [List inventory by venue](https://api-docs.tablelistpro.com/reference/listvenueinventory.md)
- [List admission groups by venue](https://api-docs.tablelistpro.com/reference/listadmissiongroups.md): Admission groups in TablelistPro represent table reservations, guestlist, tally, cover and tickets.
- [Create admission group](https://api-docs.tablelistpro.com/reference/createadmissiongroup.md): Create table reservations, guestlist, tally, cover and tickets.
- [Get admission group by id](https://api-docs.tablelistpro.com/reference/getadmissiongroupbyid.md): Get an admission group by id
- [Update admission group by id](https://api-docs.tablelistpro.com/reference/updateadmissiongroupbyid.md): Update an admission group by id
- [Bulk sync table receipts](https://api-docs.tablelistpro.com/reference/bulkcreatereceipts.md): Request body includes optional mode (default append). append: add new PUBLIC receipts to existing non-internal receipts. overwrite: replace existing non-internal receipts with only the lines sent in this request (idempotent full sync). Multiple lines for the same reservation combine in request order. Optional closed: last line per reservation wins.
- [Bulk sync reservation POS tickets](https://api-docs.tablelistpro.com/reference/bulkcreatepostickets.md): Request body includes optional mode (default append). append: new tickets are merged onto existing posTickets. overwrite: posTickets for each reservation becomes exactly the tickets sent for that reservation (idempotent full sync). Multiple lines for the same reservation combine tickets in request order before merge/replace. Optional closed: last line per reservation wins.
- [Bulk create guest list](https://api-docs.tablelistpro.com/reference/bulkcreateguestlist.md): Send date plus either blob (tab/newline format) or admissionGroups array; optional type GUEST_LIST, attributionId, eventId, inventoryId.
- [Create a reservation request](https://api-docs.tablelistpro.com/reference/createreservationrequest.md): This endpoint can be used to create table reservation leads.
- [List reservation requests by venue](https://api-docs.tablelistpro.com/reference/listreservationrequests.md): This endpoint can be used to list table reservations leads.