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

Headers

Authorization
string

OAuth 2.0 Bearer token for user-authenticated requests. Format: Bearer <access_token>. Required for GetUserPlaylists; optional for GetPlaylist if x-api-key is provided.

Example:

"Bearer eyJhbGciOiJSUzI1NiIs..."

x-api-key
string

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

Example:

"ang_live_..."

Accept-Language
string

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

Example:

"ar"

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.