Notifications

List all notifications

Retrieve a list of notifications for the authenticated team.

get/notifications

Request

  • Base URL
    https://api.midday.ai
  • URL
    https://api.midday.ai/notifications
  • Auth
    • OAuth 2
      Authorization code: https://app.midday.ai/oauth/authorize
      Token URL: https://api.midday.ai/oauth/token
    • or HTTP bearer

Query parameters

cursorstring nullable

Cursor for pagination, representing the last item from the previous page

Example:20
pageSizenumber

Number of notifications to return per page (1-100)

Example:20
'unread' | 'read' | 'archived'
OR
string[]
userIdstring uuid nullable

Filter notifications by specific user ID

Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890
priorityinteger nullable

Filter notifications by priority level (1-10)

Example:5
maxPriorityinteger nullable

Filter notifications by maximum priority level (priority <= maxPriority). Use 3 for user-facing notifications only.

Example:3

Response

Retrieve a list of notifications for the authenticated team.

Example response

{
  "data": [
    {
      "id": "b3b6e2c2-1f2a-4e3b-9c1d-2a4b6e2c21f2",
      "createdAt": "2024-04-15T09:00:00.000Z",
      "teamId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "userId": "c2d3e4f5-a6b7-8901-bcde-f23456789012",
      "type": "transactions_created",
      "priority": 3,
      "source": "system",
      "status": "unread",
      "metadata": {
        "transactionCount": 5,
        "dateRange": {
          "from": "2024-04-01",
          "to": "2024-04-15"
        }
      },
      "lastUsedAt": "2024-04-15T11:00:00.000Z"
    }
  ],
  "meta": {
    "cursor": "40",
    "hasPreviousPage": true
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.