> ## Documentation Index > Fetch the complete documentation index at: https://docs.diskograf.com/llms.txt > Use this file to discover all available pages before exploring further. # Get an album > Published album detail with its release type, release date, resolved artists with avatar URLs, and published, non-deleted songs in track order. ## OpenAPI ````yaml /openapi.json get /v1/albums/{albumId} openapi: 3.1.0 info: title: Diskograf API description: >- A public, read-only REST API over the Diskograf catalogue of Malaysian music. Public endpoints require no authentication and expose only published catalogue rows. Requests are rate limited to 360 per 60 seconds per IP address. The `/v1/admin` endpoints are the exception: authenticated with a short-lived bearer token minted by diskograf.com for Backstage staff. They bypass API rate limits and are never cached because they expose unpublished rows. Every successful response is wrapped in an envelope. List endpoints return `{ "data": [...], "meta": { "total", "limit", "offset", "next_cursor" } }`; detail endpoints return `{ "data": {...} }`. Errors return `{ "error": { "code", "message" } }`. version: 1.0.0 servers: - url: https://api.diskograf.com description: Production security: [] tags: - name: Songs description: The catalogue of published songs and their credits. - name: Albums description: Published albums and their track listings. - name: Curated Lists description: Published editorial song lists. - name: Artists description: Performers, writers and producers, and their discographies. - name: Genres description: The genre taxonomy and the songs in each genre. - name: Labels description: Record labels and their releases. - name: Users description: Public contributor profiles. Private account fields are never returned. - name: Search description: Cross-category keyword search. - name: Discovery description: Composite catalogue selections for exploring Malaysian music. - name: Meta description: Service index, statistics and health. - name: Backstage description: >- Authenticated, admin-only rows. Never cached. Requires a bearer token minted by diskograf.com. paths: /v1/albums/{albumId}: get: tags: - Albums summary: Get an album description: >- Published album detail with its release type, release date, resolved artists with avatar URLs, and published, non-deleted songs in track order. operationId: getV1AlbumsByAlbumId parameters: - name: albumId in: path required: true schema: type: integer responses: '200': description: The album. content: application/json: schema: type: object properties: data: type: object properties: id: type: integer minimum: -9007199254740991 maximum: 9007199254740991 title: type: string album_type: type: string enum: - album - ep - single description: Album release type. artwork_url: description: Absolute CDN URL for the album artwork. type: - string - 'null' artwork_colors: default: null description: Saved colours sampled from the artwork, as hex. anyOf: - type: object properties: dominant: type: string average: type: string required: - dominant - average - type: 'null' released_at: type: string description: >- Album release date, or the latest visible track release date when no album date is set. artists: type: array items: type: object properties: id: type: integer minimum: -9007199254740991 maximum: 9007199254740991 name: type: string prefix_title: type: - string - 'null' is_group: type: - boolean - 'null' avatar_url: description: Resolved public CDN URL for the artist avatar. type: - string - 'null' required: - id - name - prefix_title - is_group - avatar_url songs: type: array items: type: object properties: id: type: integer minimum: -9007199254740991 maximum: 9007199254740991 title: type: string slug: type: string description: >- URL-safe form of the title. Not unique — pair it with the id. released_at: type: string artwork_url: type: string description: >- Absolute CDN URL. Resolved server-side; never a bare storage key. artwork_average: default: null description: >- Saved average artwork colour as hex, or null until computed. type: - string - 'null' artwork_source: anyOf: - type: string enum: - Custom - Apple Music - Spotify - YouTube - type: 'null' youtube_video_id: type: - string - 'null' youtube_video_url: type: - string - 'null' youtube_views: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' youtube_views_per_day: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' artists: type: array items: type: object properties: id: type: integer minimum: -9007199254740991 maximum: 9007199254740991 name: type: string required: - id - name description: >- Primary performing credits only, in credit order. date_type: anyOf: - type: string enum: - FULL - MONTH - YEAR - type: 'null' duration_ms: anyOf: - type: integer minimum: 0 maximum: 9007199254740991 - type: 'null' youtube_duration_seconds: anyOf: - type: integer minimum: 0 maximum: 9007199254740991 - type: 'null' spotify_url: anyOf: - type: string format: uri - type: 'null' description: Canonical Spotify URL for this track. apple_music_url: anyOf: - type: string format: uri - type: 'null' description: Apple Music URL for this track. position: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - id - title - slug - released_at - artwork_url - artwork_source - youtube_video_id - youtube_video_url - youtube_views - youtube_views_per_day - artists - date_type - duration_ms - youtube_duration_seconds - spotify_url - apple_music_url - position required: - id - title - album_type - artwork_url - released_at - artists - songs required: - data '404': $ref: '#/components/responses/NotFound' components: responses: NotFound: description: The requested resource does not exist, or is not public. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - not_found - bad_request - unauthorized - forbidden - rate_limited - internal_error message: type: string required: - code - message required: - error ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.