> ## 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 User Notifications

> Returns member-specific notifications such as personal alerts or direct delivery events.

Returns member-specific notifications such as personal alerts or direct delivery events.

## Request inputs

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

<ParamField query="page" type="number">
  Page number for pagination.
</ParamField>

## Response fields

<ResponseField name="status" type="string" required>
  Indicates whether the member inbox query succeeded.
</ResponseField>

<ResponseField name="data" type="object" required>
  The paginated notification inbox for the authenticated member.
</ResponseField>

<ResponseField name="data.current_page" type="number">
  The current inbox page returned for the member.
</ResponseField>

<ResponseField name="data.data" type="object[]">
  The actual notification records shown in the member inbox.
</ResponseField>

<ResponseField name="data.data[].read_at" type="string">
  When the member read the notification, or `null` if it is still unread.
</ResponseField>

<ResponseField name="data.per_page" type="number">
  The maximum number of member notifications returned in this page.
</ResponseField>

<ResponseField name="data.total" type="number">
  The total number of member notifications available across all pages.
</ResponseField>

## Example response

```json theme={null}
{
  "status": "Success",
  "data": {
    "current_page": 1,
    "data": [
      {
        "id": "77211025-5c70-4847-81b3-ce242d1f9e77",
        "type": "general",
        "title": "Docs alert one",
        "body": "Seeded for API docs",
        "data": [],
        "read_at": null,
        "created_at": "2026-05-27T17:56:55.000000Z"
      }
    ],
    "per_page": 20,
    "total": 1
  }
}
```