> Index of every page on this site: [llms.txt](https://docs.a-line.cloud/llms.txt)

# Whoami

> The whoami operations of the v1 API.

## Describe the calling API key

`GET /v1/whoami` (operation ID `whoami`)

Describe the calling API key: its id, organization and scope.

Read-only and allowed for every scope, so automation can check that its key may write before it starts a change.

Authentication: `api_key` ([how to authenticate](/api/authentication)).

**Responses**

- `200`: The calling key. Body: [`V1Whoami`](/api/reference/schemas#v1whoami).
- `401`: Missing, invalid or revoked API key.
- `429`: This API key spent its request budget for the current window (code `rate_limited`); retry after `Retry-After` seconds. Body: [`V1Error`](/api/reference/schemas#v1error).

```bash
curl 'https://api.a-line.cloud/v1/whoami' \
  -H 'Authorization: Bearer alc_test_EXAMPLE_not_a_real_key'
```
