# Describe the key that calls

:::openapi-operation GET /api/v1/me
AUTH bearerAuth
:::

Returns the name, prefix and expiry of the key, its org and plan, and the role of its owner. It also lists the bound workspace, the workspaces that the key reaches and the permissions that it can use. blocked lists the permissions that the key holds but cannot use, with the reason: role, two_factor or plan. Any valid key may call it. The response holds no email and no user id.

:::codesamples open Code examples

```bash:curl
curl -X GET "https://contextowl.co/api/v1/me" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <token>"
```

:::

:::details open Success responses (200)

#### 200

Success

**Content-Type:** `application/json`

| FIELD | TYPE | REQUIRED | DESCRIPTION |
| --- | --- | --- | --- |
| `blocked` | array items: BlockedPermission object | yes | The permissions that the key holds but cannot use |
| `boundWorkspace` | string | no | The workspace that the key is bound to, or null for a key that is not bound |
| `key` | KeyInfo object | yes | - |
| `org` | IdentityOrg object | yes | - |
| `permissions` | array items: string | yes | The permissions that the key can use, sorted |
| `role` | string | yes | Current org role of the key owner: admin, editor, viewer, billing or guest |
| `workspaces` | array items: WorkspaceAccess object | yes | The workspaces that the key reaches, sorted by name |

```json
{
  "blocked": [
    {
      "permission": "string",
      "reason": "string"
    }
  ],
  "boundWorkspace": "string",
  "key": {
    "expiresAt": "string",
    "name": "string",
    "prefix": "string"
  },
  "org": {
    "id": "string",
    "name": "string",
    "plan": "string"
  },
  "permissions": [
    "string"
  ],
  "role": "string",
  "workspaces": [
    {
      "accessMode": "string",
      "id": "string",
      "name": "string"
    }
  ]
}
```

:::

:::details Error responses (401, 429, 500)

#### 401

unauthorized: the access key is missing, invalid or expired.

**Content-Type:** `application/json`

| FIELD | TYPE | REQUIRED | DESCRIPTION |
| --- | --- | --- | --- |
| `error` | object | yes | - |

```json
{
  "error": {
    "code": "string",
    "details": null,
    "message": "string",
    "status": 0
  }
}
```

#### 429

rate_limited: too many requests. Wait for the time in the Retry-After header.

**Content-Type:** `application/json`

| FIELD | TYPE | REQUIRED | DESCRIPTION |
| --- | --- | --- | --- |
| `error` | object | yes | - |

```json
{
  "error": {
    "code": "string",
    "details": null,
    "message": "string",
    "status": 0
  }
}
```

#### 500

internal: the server failed.

**Content-Type:** `application/json`

| FIELD | TYPE | REQUIRED | DESCRIPTION |
| --- | --- | --- | --- |
| `error` | object | yes | - |

```json
{
  "error": {
    "code": "string",
    "details": null,
    "message": "string",
    "status": 0
  }
}
```

:::