Skip to main content
GET
/
v1
/
notifications
Get Notifications
curl --request GET \
  --url https://api.thefaithapp.com/v1/notifications \
  --header 'Authorization: Bearer <token>' \
  --header 'X-API-Key: <x-api-key>'
{
  "current_page": 123,
  "data": [
    {}
  ],
  "data[].image_url": "<string>",
  "per_page": 123,
  "total": 123
}
Retrieves a paginated list of notifications for the authenticated user’s church.
  • Requires both an API key and a TheFaithApp member bearer token.
  • Supports optional pagination.

Request inputs

X-API-Key
string
required
Your client API key from the dashboard (Settings page).
page
number
Page number for pagination (default: 1).

Response fields

current_page
number
The current page of church-wide notifications.
data
object[]
required
The shared notification feed for the authenticated member’s church.
data[].image_url
string
The resolved church image shown alongside each church-wide notification.
per_page
number
The maximum number of notification records returned in this page.
total
number
The total number of church notifications available across all pages.

Example response

{
  "current_page": 1,
  "data": [
    {
      "id": 9,
      "client_id": 12,
      "title": "Prayer and Fasting Week",
      "body": "<p>Join us this week for prayer and fasting.</p>",
      "created_at": "2026-05-27T09:00:00.000000Z",
      "updated_at": "2026-05-27T09:00:00.000000Z",
      "image_url": "https://cdn.example.com/clients/example.png"
    }
  ],
  "per_page": 10,
  "total": 1
}
For member-specific notifications, see the Manage User Notifications page.