> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tikk.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Tikk REST API. Profile, availability and bookings

> Programmatic access to your profile, availability and bookings. Base URL https://app.tikk.chat/api/v1. JSON responses.

The Tikk API is a read-only REST API for your own data. Your public profile and services, your available time slots and the bookings people have made with you. 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:

```text theme={null}
https://app.tikk.chat/api/v1
```

## 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

## Endpoints

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

<CardGroup cols={2}>
  <Card title="GET /profile" icon="user" href="/api-reference/profile/get-profile">
    Retrieve your public profile, username, and active services.
  </Card>

  <Card title="GET /availability" icon="calendar" href="/api-reference/availability/list-availability">
    List your free time slots by day for a given date range.
  </Card>

  <Card title="GET /bookings" icon="list" href="/api-reference/bookings/list-bookings">
    Retrieve a paginated list of all bookings on your account.
  </Card>

  <Card title="GET /bookings/{id}" icon="bookmark" href="/api-reference/bookings/get-booking">
    Look up a single booking by its unique identifier.
  </Card>
</CardGroup>

## Next steps

Before making your first request, read the [Authentication](/api-reference/authentication) page to learn how to obtain and send a credential, then review [Scopes](/api-reference/scopes) to understand which permissions each endpoint requires.
