---
title: "The company and the key"
method: GET
path: "/me"
tags: ["meta"]
---

# The company and the key

`GET /me`

## Request

- Base URL: `https://api.taktovka.com/v1`
- URL: `https://api.taktovka.com/v1/me`
- Auth: HTTP bearer

Which company this key reads, the scopes it carries and the rate limit it is held to. Any live key may call it.

## Response `200`

OK

- object
  - `data` Me, required
    - `company` object, required
      - `id` string, uuid, required
      - `name` string, required
      - `country` 'SK' | 'CZ', required
      - `currency` 'EUR' | 'CZK', required
      - `locale` string, required
      - `tz` string, required: IANA time zone of the company
      - `plan` 'free' | 'kaviaren' | 'restauracia' | 'siet' | 'enterprise', required
    - `key` object, required
      - `id` string, uuid, required
      - `name` string, required
      - `scopes` string[], required
      - `created_at` string, date-time, required: ISO 8601 instant
      - `expires_at` string, date-time, nullable, required: ISO 8601 instant
    - `rate_limit` object, required
      - `per_second` integer, required
      - `burst` integer, required

## Other responses

- `400`: key_in_query
- `401`: unauthenticated, invalid_key, key_revoked or key_expired
- `403`: insufficient_scope (with required_scope)
- `429`: rate_limited (with retry_after and a Retry-After header)

---

[API](https://skmtc.dev/taktovka/apis/taktovka-api.md) · [All operations](https://skmtc.dev/taktovka/apis/taktovka-api/llms.txt) · [OpenAPI document](https://skmtc.dev/taktovka/apis/taktovka-api/revisions/612199b365e1?raw)
