# Check your API key

> Who your key belongs to, which key it is, and the accounts connected so far. Read-only.

Canonical: <https://www.tryadeli.com/docs/api/me>

`GET https://app.tryadeli.com/api/v1/me`

Authorization: `Bearer <API key>` — see [Authentication](https://www.tryadeli.com/docs/authentication)

Answers with who your API key belongs to, which key it is, and the accounts
connected to a profile. It is read-only, calls no social platform, and returns
the same fields whether or not anything is connected, so it is the quickest way
to check that a key works.

Keys belong to your organization, not to one profile, so `profileId` is
optional and defaults to your organization's default profile.

**Query parameters**

| Name        | Type   | Required | Description                                                                                                                                         |
| ----------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `profileId` | `uuid` |          | The profile whose connected accounts to list. Defaults to the default profile. A profile outside your organization returns `404 profile_not_found`. |

**Response**

| Name                | Type             | Required | Description                                                                                                                                             |
| ------------------- | ---------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `message`           | `string`         |          | A greeting that confirms the key works. The same on every call.                                                                                         |
| `you.name`          | `string \| null` |          | The person who created the key, or `null` once they have left your organization.                                                                        |
| `you.organization`  | `string`         |          | Your organization's name.                                                                                                                               |
| `you.profile`       | `object`         |          | The profile the accounts belong to: `id` and `name`.                                                                                                    |
| `apiKey`            | `object`         |          | The key's `label`, its visible `prefix`, and when it was created (`createdAt`). Never the secret.                                                       |
| `accountsConnected` | `array`          |          | The profile's working connections, each with `accountId`, `platform` and `username`. Empty when nothing is connected; expired connections are left out. |
| `docs`              | `string`         |          | Where these docs live.                                                                                                                                  |

**Errors** — `401 unauthorized`, `400 invalid_request`, `404 profile_not_found`,
`502 database_error`.

## Request examples

**cURL**

```bash
curl "https://app.tryadeli.com/api/v1/me" \
  -H "Authorization: Bearer $ADELI_API_KEY"
```

**JavaScript**

```javascript
const response = await fetch("https://app.tryadeli.com/api/v1/me", {
  headers: {
    Authorization: `Bearer ${process.env.ADELI_API_KEY}`,
  },
});
console.log(await response.json());
```

**Python**

```python
import os

import requests

response = requests.get(
    "https://app.tryadeli.com/api/v1/me",
    headers={"Authorization": f"Bearer {os.environ['ADELI_API_KEY']}"},
)
print(response.json())
```

## Responses

### 200

```json
{
  "message": "Hello from Adeli 👋 Your API key works.",
  "you": {
    "name": "Mika Reyes",
    "organization": "King's Cross Labs",
    "profile": { "id": "00000000-0000-4000-8000-000000000001", "name": "King's Cross Labs" }
  },
  "apiKey": {
    "label": "Quickstart",
    "prefix": "rk_live_AbCd1234",
    "createdAt": "2026-10-15T21:04:00.000Z"
  },
  "accountsConnected": [
    { "accountId": "00000000-0000-0000-0000-000000000000", "platform": "instagram", "username": "adeli" }
  ],
  "docs": "https://www.tryadeli.com/docs"
}
```

### 401

```json
{
  "error": {
    "code": "unauthorized",
    "message": "A valid Bearer API key is required"
  }
}
```