v50

latestOpenAPI 3.0.0raw.githubusercontent.com2026-01-29166197289.1 KB
notifications

List notifications

All notifications for the user can be listed, including notifications created by MX for other channels besides PUSH.

get/users/{user_guid}/notifications

Query parameters

from_datestring

Filter transactions from this date. This only supports ISO 8601 format without timestamp (YYYY-MM-DD). Defaults to 120 days ago if not provided.

to_datestring

Filter transactions to this date (at midnight). This only supports ISO 8601 format without timestamp (YYYY-MM-DD). Defaults to 5 days forward from the day the request is made to capture pending transactions.

pageinteger

Results are paginated. Specify current page.

records_per_pageinteger

This specifies the number of records to be returned on each page. Defaults to 25. The valid range is from 10 to 1000. If the value exceeds 1000, the default value of 25 will be used instead.

Response

OK

Example response

{
  "notifications": [
    {
      "guid": "TF-b53294f5-2356-4782-9f81-ae064c42b40a",
      "content": "The content related to the notification.",
      "deep_link_guid": "BGT-e386a323-e452-47f2-b2fd-1ac3c18533de",
      "entity_guid": "BGT-e386a323-e452-47f2-b2fd-1ac3c18533de",
      "has_been_delivered": true,
      "notification_type": 2,
      "subject": "You're projected to spend $1,920.07 more than you've budgeted for Fees & Charges. You've already spent $65.67 of $316.00.",
      "channel": "push"
    }
  ]
}