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:

http

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 are set for your environment. Contact support if your integration needs a higher limit.

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

The full GraphQL schema is available through introspection on the API endpoint, and any GraphQL client (GraphiQL, Apollo Sandbox, Insomnia) renders it interactively. Developer support is also available through the in-app chat.