---
title: "List the background-music catalog"
method: GET
path: "/api/music_library"
tags: ["Video"]
---

# List the background-music catalog

`GET /api/music_library`

## Request

- Base URL: `https://app.pedra.ai`
- URL: `https://app.pedra.ai/api/music_library`
- Auth: none required

Returns the valid `music.track` values (genre keys) with display labels, plus the languages accepted by the voiceover endpoints. Read-only — never deducts credits. Also available as POST.

## Response `200`

Music catalog and voice languages.

- object
  - `tracks` object[]
    - `track` string: Genre key for music.track.
    - `label` string: Display label.
  - `variantsPerTrack` integer: Number of shuffled variants per genre.
  - `defaultTrack` string: Default genre key.
  - `voiceLanguages` string[]: Languages accepted by generate_voice / generate_voice_script.

## Other responses

- `405`: Wrong HTTP method — all endpoints accept POST (credits also accepts GET).

---

[API](https://skmtc.dev/pedra/apis/pedra-api.md) · [All operations](https://skmtc.dev/pedra/apis/pedra-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pedra/apis/pedra-api/revisions/87b2e76912c8?raw)