Returns the user’s notification inbox (30-day retention) with server-translated title and body. Optional locale (see Locales); when omitted, uses preferredLanguage, else en. Paginate with pageToken / limit (default 30, max 100).
GET
/v1/list_notificationsQuery
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| locale | string | No | — | Supported locale code. Omit to use the user’s preferred language. |
| pageToken | string | No | — | Cursor from a previous response’s nextPageToken. |
| limit | number | No | 30 | Page size (1–100; default 30). |
Response data
| Field | Type | Description |
|---|---|---|
| locale | string | Locale used for title/body. |
| items | array | Inbox notifications. |
| nextPageToken | string | Pass as pageToken for the next page when present. |
Item fields
| Field | Type | Description |
|---|---|---|
| id | string | Notification id. |
| type | string | Notification type (e.g. budget_update), or null. |
| budgetId | string | Related budget id when present, or null. |
| budgetName | string | Related budget name when present, or null. |
| createdAt | string | ISO-8601 creation time, or null. |
| readAt | string | ISO-8601 when marked read, or null. |
| title | string | Translated title. |
| body | string | Translated body. |