# Cicini API

> Developer documentation for the Cicini Public API v1

## Docs

- [List appointments](https://docs.cicini.com/api-reference/appointments/list-appointments.md): Returns a paginated list of active appointments for the organization associated with the API key. Supports status, customer, staff, and date filters.
- [List customers](https://docs.cicini.com/api-reference/customers/list-customers.md): Returns a paginated list of active customers for the organization associated with the API key.
- [cURL cookbook](https://docs.cicini.com/examples/curl.md): Practical curl recipes for Public API v1
- [Node.js example](https://docs.cicini.com/examples/node.md): Fetch all customers with pagination using Node 18+ native fetch
- [Public vs internal](https://docs.cicini.com/guides/api-surface.md): What is safe for integrations vs Cicini-only APIs
- [Authentication](https://docs.cicini.com/guides/authentication.md): Organization API keys for the Cicini Public API
- [Errors](https://docs.cicini.com/guides/errors.md): Status codes and error response shape for Public API v1
- [Getting started](https://docs.cicini.com/guides/getting-started.md): Base URL, first request, and how to page through Public API v1
- [Pagination](https://docs.cicini.com/guides/pagination.md): limit, offset, and hasMore on Public API v1 list endpoints
- [Rate limits](https://docs.cicini.com/guides/rate-limits.md): Honest guidance on Public API v1 throughput and plan catalog limits
- [Overview](https://docs.cicini.com/index.md): Build server-side integrations with the Cicini Public API v1
- [Appointments](https://docs.cicini.com/resources/appointments.md): List organization appointments (bookings / reservations) via Public API v1
- [Customers](https://docs.cicini.com/resources/customers.md): List organization customers via Public API v1

## OpenAPI Specs

- [openapi](https://docs.cicini.com/openapi.json)