> ## 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. # GetUserPlaylists > GetUserPlaylists retrieves the authenticated user's playlists. Requires an OAuth access token with the "read" scope. Authorization is declared at service level; sebuf v0.13 currently emits duplicate identifiers when a method-level header reuses a service-level name. ## OpenAPI ````yaml /api/anghami-sdk.openapi.yaml get /v1/playlists openapi: 3.1.0 info: title: Anghami + OSN+ SDK description: >- Unified OpenAPI bundle covering all Anghami + OSN+ SDK services (music + video streaming). contact: name: Anghami Developer Platform email: developers@anghami.com version: 1.0.0 servers: - url: https://sdk.anghami.com security: [] paths: /v1/playlists: get: tags: - PlaylistService summary: GetUserPlaylists description: |- GetUserPlaylists retrieves the authenticated user's playlists. Requires an OAuth access token with the "read" scope. Authorization is declared at service level; sebuf v0.13 currently emits duplicate identifiers when a method-level header reuses a service-level name. operationId: GetUserPlaylists parameters: - name: Authorization in: header description: >- OAuth 2.0 Bearer token for user-authenticated requests. Format: Bearer . Required for GetUserPlaylists; optional for GetPlaylist if x-api-key is provided. required: false schema: type: string example: Bearer eyJhbGciOiJSUzI1NiIs... - name: x-api-key in: header description: >- API key for server-to-server access. Only valid for GetPlaylist on public playlists. required: false schema: type: string example: ang_live_... - name: Accept-Language in: header description: Preferred locale for localized content in playlist items (BCP 47). required: false schema: type: string example: ar - name: page_size in: query description: Maximum number of playlists to return per page (1-100, default 20). required: false schema: type: integer format: int32 - name: page_token in: query description: Opaque page token from a previous response. Omit for the first page. required: false schema: type: string responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/sdk_playlist_v1_GetUserPlaylistsResponse' '400': description: Validation error content: application/json: schema: $ref: '#/components/schemas/ValidationError' default: description: Error response content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: sdk_playlist_v1_GetUserPlaylistsResponse: type: object properties: playlists: type: array items: $ref: '#/components/schemas/sdk_playlist_v1_Playlist' nextPageToken: type: string description: Token for the next page of results. Empty if no more pages. description: >- GetUserPlaylistsResponse is the response message containing the user's playlists. ValidationError: type: object properties: violations: type: array items: $ref: '#/components/schemas/FieldViolation' description: List of validation violations required: - violations description: >- ValidationError is returned when request validation fails. It contains a list of field violations describing what went wrong. Error: type: object properties: message: type: string description: Error message (e.g., 'user not found', 'database connection failed') description: >- Error is returned when a handler encounters an error. It contains a simple error message that the developer can customize. sdk_playlist_v1_Playlist: type: object properties: id: $ref: '#/components/schemas/sdk_shared_v1_PlaylistID' name: $ref: '#/components/schemas/sdk_shared_v1_LocalizedString' description: $ref: '#/components/schemas/sdk_shared_v1_LocalizedString' visibility: type: string enum: - PLAYLIST_VISIBILITY_UNSPECIFIED - PLAYLIST_VISIBILITY_PUBLIC - PLAYLIST_VISIBILITY_PRIVATE description: PlaylistVisibility defines whether a playlist is publicly visible. ownerId: $ref: '#/components/schemas/sdk_shared_v1_UserID' ownerName: type: string description: Display name of the playlist owner. coverArtwork: $ref: '#/components/schemas/sdk_shared_v1_Image' itemCount: type: integer format: int32 description: Total number of items in the playlist. totalDurationMs: type: string format: int64 description: Total duration of all items in milliseconds. createdAt: type: string description: ISO 8601 timestamp of when the playlist was created. updatedAt: type: string description: ISO 8601 timestamp of when the playlist was last updated. description: Playlist represents a user-created or editorial playlist. FieldViolation: type: object properties: field: type: string description: >- The field path that failed validation (e.g., 'user.email' for nested fields). For header validation, this will be the header name (e.g., 'X-API-Key') description: type: string description: >- Human-readable description of the validation violation (e.g., 'must be a valid email address', 'required field missing') required: - field - description description: FieldViolation describes a single validation error for a specific field. sdk_shared_v1_PlaylistID: type: object properties: value: type: string description: The string value of the playlist identifier. required: - value description: PlaylistID is a typed identifier for a playlist. sdk_shared_v1_LocalizedString: type: object properties: value: type: string description: |- The text value resolved for the requested locale. The server selects this based on the Accept-Language header. originalValue: type: string description: |- The text value in its original language. For content originally in Arabic, this is the Arabic text. For content originally in English/Latin, this is the English text. May be identical to value when the requested locale matches the original. description: |- LocalizedString provides a text value in the requested locale along with the original-language value. The resolved value is determined server-side from the Accept-Language request header. Anghami's catalog is Arabic-first, meaning most content has both Arabic and Latin/transliterated titles. This message allows clients to display either representation as needed by the user interface. sdk_shared_v1_UserID: type: object properties: value: type: string description: The string value of the user identifier. required: - value description: UserID is a typed identifier for a user. sdk_shared_v1_Image: type: object properties: url: type: string description: URL of the image. width: type: integer format: int32 description: Width in pixels. height: type: integer format: int32 description: Height in pixels. description: Image represents artwork or visual media at a specific size. ````