# Get the current docs session
URL: https://musicapi.com/docs/reference/get-docs-session.md

`GET https://api.musicapi.com/public/docs-sessions/current`

Section: Get started.
Product: MusicAPI Core and MusicAPI Managed Transfers.
Auth: DocsSession (any one of them). Use Basic with your Client ID and Client Secret from your server only.

## Response 200

OK

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `expiresAt` | date-time | yes |  |
| `kind` | string | yes | One of: partner, sandbox. |
| `account` | DocsSessionAccount | yes |  |
| `account.name` | string | yes |  |
| `account.slug` | string | yes |  |
| `account.clientId` | uuid \| null | yes | Your oldest live Client ID. Never a Client Secret. |
| `account.returnUrls` | string[] | yes |  |
| `account.isEvaluationAccount` | boolean | yes | True while the account is capped at 5 connected users. |
| `account.isTransferServiceEnabled` | boolean | yes | True when MusicAPI Managed Transfers is on for the account. |
| `account.enabledIntegrations` | string[] | yes |  |
| `connectedUser` | DocsConnectedUser \| null | no | Sandbox sessions only: the connected account of a bound session, else `null`. |
| `connectedUser.uuid` | uuid | yes | The `integrationUserUUID` of the account. |
| `connectedUser.integrationType` | string | yes | The service, for example `spotify`. |
| `connectedUser.name` | string \| null | yes |  |
| `connectedUser.imageUrl` | string \| null | yes |  |

```json
{
  "expiresAt": "2026-10-16T09:41:07.000Z",
  "kind": "partner",
  "account": {
    "name": "Acme Music",
    "slug": "acme",
    "clientId": "5b0c6f0e-2c8a-4d0e-9a51-7e3f1c2d9b44",
    "returnUrls": [
      "string"
    ],
    "isEvaluationAccount": true,
    "isTransferServiceEnabled": true,
    "enabledIntegrations": [
      "spotify"
    ]
  },
  "connectedUser": {
    "uuid": "5b0c6f0e-2c8a-4d0e-9a51-7e3f1c2d9b44",
    "integrationType": "string",
    "name": "string",
    "imageUrl": "string"
  }
}
```

## Errors

- 401: `docsSessionEnded`: the token expired or was revoked. Sign in again.

## Example

```bash
curl https://api.musicapi.com/public/docs-sessions/current \
  -H "Authorization: DocsSession $MUSICAPI_DOCS_SESSION"
```