> ## 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 albums

> List a creator’s albums or public albums.

With neither `creator` nor `public=true`, the response is an empty array. There are no pagination parameters. Album visibility is a catalog setting, not a private storage boundary.

## Headers and parameters

<ParamField query="creator" type="string">
  Creator address; takes precedence over public.
</ParamField>

<ParamField query="public" type="string">
  Set the literal string true for public albums.
</ParamField>

## Response (200)

Success.

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

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

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

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

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

    <ResponseField name="public" type="boolean" />

    <ResponseField name="created_at" type="string" />
  </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. |
| `500` | Request failed. |

<RequestExample>
  ```bash cURL theme={null}
  curl --fail-with-body -X GET "$RAWCHUNKS_API/api/albums"
  ```
</RequestExample>


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