Skip to main content
The Tikk API is a REST API for your own data. Your public profile and services, your available time slots, the bookings people have made with you and your single-use links. Reading is the default. Writing is limited to your services (create, edit and delete) and your webhooks, which push booking updates to a URL as they happen. Every endpoint responds with JSON and requires a valid bearer token. No public, unauthenticated routes.

Base URL

All requests go to the following base URL:

Key characteristics

  • All responses are JSON
  • All timestamps are ISO 8601 in UTC
  • Every request must include a bearer token in the Authorization header
  • Rate limit: 60 requests per minute per credential
Building an app that other Tikk users connect to? Register it and follow the OAuth guide in the developer portal.

Endpoints

Use the cards below to jump to each endpoint’s reference page.

GET /profile

Retrieve your public profile, username and plan.

GET /services

List the services visitors can book right now.

GET /services/{id}

Look up a service by its id.

POST /services

Create a default service or a single-use link.

PATCH /services/{id}

Edit a default service.

DELETE /services/{id}

Delete a service.

GET /availability

List your free time slots by day for a given date range.

GET /bookings

Retrieve a paginated list of all bookings on your account.

GET /bookings/{id}

Look up a single booking by its unique identifier.

Webhooks

Get booking updates pushed to your URL as they happen (Pro).

Next steps

Before making your first request, read the Authentication page to learn how to obtain and send a credential, then review Scopes to understand which permissions each endpoint requires.