> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rawchunks.space/llms.txt
> Use this file to discover all available pages before exploring further.

# List saved voices

> List the selected creator’s saved voices.

## Headers and parameters

<ParamField query="creator" type="string" required>
  Selected creator address.
</ParamField>

<ParamField header="x-session-user-address" type="string" required>
  Selected account address. Required for owner-scoped reads and writes. It identifies the account; your product must authenticate its own users.
</ParamField>

## Response (200)

Success.

<ResponseField name="voices" type="object[]" required>
  <Expandable title="Properties">
    <ResponseField name="id" type="string" required />

    <ResponseField name="name" type="string" required />

    <ResponseField name="creator" type="string" required />

    <ResponseField name="sample_url" type="string | null" />

    <ResponseField name="source_song_id" type="string | null" />

    <ResponseField name="status" type="string" required>
      Values: `saved`, `extracting`, `queued`, `training`, `ready`, `error`.
    </ResponseField>

    <ResponseField name="error" type="string | null" />

    <ResponseField name="availability" type="object">
      <Expandable title="Properties">
        <ResponseField name="turbo" type="object">
          <Expandable title="Properties">
            <ResponseField name="model" type="string" />

            <ResponseField name="status" type="string">
              Check ready for the generation mode you will use.
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="sft" type="object">
          <Expandable title="Properties">
            <ResponseField name="model" type="string" />

            <ResponseField name="status" type="string">
              Check ready for the generation mode you will use.
            </ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

## Errors

Failed JSON responses contain an `error` string. Check the HTTP status before reading a successful result. See [job handling](/dev/guides/jobs) for interrupted or uncertain submissions.

| Status | Meaning |
| - | - |
| `400` | Invalid request. |
| `403` | Account does not match resource. |
| `404` | Resource not found. |
| `409` | Resource conflict; reload state or open an editable version. |
| `500` | Request failed. |

<RequestExample>
  ```bash cURL theme={null}
  curl --fail-with-body -X GET "$RAWCHUNKS_API/api/voices?creator=$(jq -nr --arg v "$CREATOR" '$v|@uri')" \
    -H "x-session-user-address: $USER_ADDRESS"
  ```
</RequestExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.