Skip to main content
GET
/
v1
/
library
/
history
GetHistory
curl --request GET \
  --url https://sdk.anghami.com/v1/library/history \
  --header 'Authorization: <authorization>'
{
  "entries": [
    {
      "content": {
        "songId": {
          "value": "<string>"
        },
        "albumId": {
          "value": "<string>"
        },
        "artistId": {
          "value": "<string>"
        },
        "playlistId": {
          "value": "<string>"
        },
        "showId": {
          "value": "<string>"
        },
        "seasonId": {
          "value": "<string>"
        },
        "episodeId": {
          "value": "<string>"
        },
        "movieId": {
          "value": "<string>"
        },
        "title": "<string>",
        "subtitle": "<string>",
        "artwork": {
          "url": "<string>",
          "width": 123,
          "height": 123
        }
      },
      "playedAt": "<string>"
    }
  ],
  "nextPageToken": "<string>"
}

Headers

​
Authorization
string
required

OAuth 2.0 Bearer token with the 'read' scope. Required for all library operations. Format: Bearer <access_token>.

Example:

"Bearer eyJhbGciOiJSUzI1NiIs..."

​
Accept-Language
string

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

Example:

"ar"

Query Parameters

​
content_type
string

Optional filter by content type. If UNSPECIFIED, returns all content types.

​
page_size
integer<int32>

Maximum number of items 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

GetHistoryResponse is the response message containing the user's playback history.

​
entries
object[]
​
nextPageToken
string

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