Skip to the content
Get an API key
  1. API reference
  2. Get started

Get the current docs session

GET/public/docs-sessions/current
Core + Managed TransfersAuthDocsSession

Response

200application/json · DocsSessionCurrentOK
expiresAt
date-time
required
kind
string
requiredOne of: partner, sandbox
account
DocsSessionAccount
required
account.name
string
required
account.slug
string
required
account.clientId
uuid | null
requiredYour oldest live Client ID. Never a Client Secret.
account.returnUrls
string[]
required
account.isEvaluationAccount
boolean
requiredTrue while the account is capped at 5 connected users.
account.isTransferServiceEnabled
boolean
requiredTrue when MusicAPI Managed Transfers is on for the account.
account.enabledIntegrations
string[]
required
connectedUser
DocsConnectedUser | null
Sandbox sessions only: the connected account of a bound session, else null.
connectedUser.uuid
uuid
requiredThe integrationUserUUID of the account.
connectedUser.integrationType
string
requiredThe service, for example spotify.
connectedUser.name
string | null
required
connectedUser.imageUrl
string | null
required
Example answer
{
  "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.