API overview

An introduction to the Timerise API — authentication, endpoints, SDKs, rate limits, and webhooks.

Updated March 1, 2026apigraphqlrestdevelopmentsdk

The Timerise API

The Timerise API allows you to manage bookings, services, and availability programmatically. The base URL for all API calls is:

https://api.timerise.io/v1

Authentication

All requests require an API key passed as a Bearer token:

Authorization: Bearer YOUR_API_KEY

Navigate to Settings → API in your project to generate an API key. Store it securely — it will not be displayed again after creation.

See Authentication & API Keys for full details on the login mutation and static API keys.

Core operations

Bookings

Operation	Description
`GET /bookings`	List all bookings
`POST /bookings`	Create a booking
`GET /bookings/:id`	Retrieve booking details
`PATCH /bookings/:id`	Update a booking
`DELETE /bookings/:id`	Cancel a booking

Services

Operation	Description
`GET /services`	List all services
`POST /services`	Create a service
`GET /services/:id`	Retrieve service details

Availability

Operation	Description
`GET /availability`	Check available time slots

Rate limits

Rate limits are applied per API key and vary by plan:

Plan	Requests per hour
Free	100
Professional	1,000
Enterprise	Custom

Webhooks

Subscribe to real-time events by configuring webhooks in Settings → Webhooks. Available events include:

booking.created
booking.updated
booking.cancelled

Official SDKs

Official SDK libraries are available for:

JavaScript / TypeScript
Python
Ruby
PHP

Example: create a booking

const response = await fetch('https://api.timerise.io/v1/bookings', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY',
  },
  body: JSON.stringify({
    service_id: 'YOUR_SERVICE_ID',
    customer: { name: 'Jane Smith', email: 'jane@example.com' },
    start_time: '2026-04-01T10:00:00Z',
    duration: 60,
  }),
});

API Explorer

Explore the full GraphQL schema interactively at https://docs.timerise.io/. Developer support is also available through the in-app chat.