Appointment Tools API
Build bookings, read availability, manage the services you sell and look up customers — directly from your own software.
Base URL — all endpoints live under
https://app.appointment.dev/api/v1 and return JSON.
How it works
The API is a versioned REST interface. Authenticate with a Bearer API key,
call resource endpoints, and receive a consistent response envelope. Every
response carries a meta.request_id you can quote in support
requests.
A first request
List the services (products) your business offers:
Request
curl https://app.appointment.dev/api/v1/products \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"data": [
{
"product_id": 42,
"product_name": "60-minute consultation",
"price": "120.00",
"duration_minutes": 60,
"is_active": 1
}
],
"meta": {
"request_id": "req_1a2b3c4d5e6f7a8b",
"pagination": {
"page": 1, "per_page": 25,
"count": 1, "total": 1,
"total_pages": 1, "has_more": false
}
}
}Resources
Each endpoint is labelled with a status: Live available now · Beta available, may change · Planned documented, not yet released.
| Resource | What you can do | Status |
|---|---|---|
| Products | List, create, update and delete the services and events customers book. | Live |
| Availability | Read bookable time slots for a product on a given day, and your weekly business hours. | Live |
| Bookings | Create bookings, list and filter them, update status, and cancel. | Live |
| Customers | List and search customers and read a customer's booking history. | Live |
| Coupons | List and read your booking discount codes. | Live |
| FAQs | List and read the FAQs shown on your booking pages. | Live |
| Testimonials | List and read customer testimonials. | Live |
| Newsletter | List your newsletter subscribers. | Live |
| Invoices | List and read invoices, with line items and payments. | Live |
| Webhooks | Register endpoints to receive signed booking and invoice events. | Live |
Next steps
- Quickstart — make your first authenticated request.
- Authentication — generate and manage API keys.
- API reference — every endpoint, parameter and schema.
- OpenAPI spec — the machine-readable source of truth.