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

# List Favorites

> Lists the favorite media items saved by the authenticated member.

Lists the favorite media items saved by the authenticated member.

## Request inputs

<ParamField header="X-API-Key" type="string" required>
  Your client API key from the dashboard (Settings page).
</ParamField>

## Response fields

<ResponseField name="status" type="string" required>
  Indicates whether the favorites list loaded successfully.
</ResponseField>

<ResponseField name="data" type="object" required>
  The favorites wrapper returned for the authenticated member.
</ResponseField>

<ResponseField name="data.favorites" type="object[]">
  The media items the member has already marked as favorites.
</ResponseField>

<ResponseField name="data.favorites[].pivot" type="object">
  Join-table metadata showing which member favorited which media record.
</ResponseField>

<ResponseField name="data.favorites[].media_type" type="string">
  The stored media type value for the favorited content.
</ResponseField>

## Example response

```json theme={null}
{
  "status": "Success",
  "data": {
    "favorites": [
      {
        "id": 1,
        "title": "Spirit Song",
        "source": "audios/example-audio.mp3",
        "media_type": "0",
        "pivot": {
          "member_id": 1,
          "media_id": 1
        }
      }
    ]
  }
}
```