Skip to main content
GET
/
v1
/
playlists
GetUserPlaylists
curl --request GET \
  --url https://sdk.anghami.com/v1/playlists \
  --header 'Authorization: <authorization>'
{
  "playlists": [
    {
      "id": {
        "value": "<string>"
      },
      "name": {
        "value": "<string>",
        "originalValue": "<string>"
      },
      "description": {
        "value": "<string>",
        "originalValue": "<string>"
      },
      "visibility": "PLAYLIST_VISIBILITY_UNSPECIFIED",
      "ownerId": {
        "value": "<string>"
      },
      "ownerName": "<string>",
      "coverArtwork": {
        "url": "<string>",
        "width": 123,
        "height": 123
      },
      "itemCount": 123,
      "totalDurationMs": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>"
    }
  ],
  "nextPageToken": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.sdk.anghami.com/llms.txt

Use this file to discover all available pages before exploring further.

Headers

Accept-Language
string

Preferred locale for localized content in playlist items (BCP 47).

Example:

"ar"

Authorization
string
required

OAuth 2.0 Bearer token with the 'read' scope. Required for listing the authenticated user's playlists.

Example:

"Bearer eyJhbGciOiJSUzI1NiIs..."

x-api-key
string

API key for server-to-server access. Only valid for GetPlaylist on public playlists.

Example:

"ang_live_..."

Query Parameters

page_size
integer<int32>

Maximum number of playlists to return per page (1-100, default 20).

page_token
string

Opaque page token from a previous response. Omit for the first page.

Response

Successful response

GetUserPlaylistsResponse is the response message containing the user's playlists.

playlists
object[]
nextPageToken
string

Token for the next page of results. Empty if no more pages.