Skip to main content
GET
/
notification-list
List notifications
curl --request GET \
  --url https://aarwcjjzhlmkgdwrisyt.supabase.co/functions/v1/notification-list \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "status": 200,
  "data": [
    {
      "id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
      "conversation_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "escrow_id": "d4e5f6a7-b8c9-0123-defa-234567890123",
      "user_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
      "event_type": "payment_requested",
      "content": "Payment request sent. Amount: NGN 150000.",
      "entity_type": "transaction",
      "entity_id": "a7b8c9d0-e1f2-3456-abcd-567890123456",
      "action_label": "Fund Escrow",
      "is_read": false,
      "created_at": "2026-04-18T09:00:00Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

JWT access token obtained from /auth-verify (login context) or /auth-signup. Set the bearer_token environment variable in your API client to apply it globally.

Query Parameters

​
escrow_id
string<uuid>

Filter notifications to a specific escrow

​
limit
integer
default:50
Required range: 1 <= x <= 100
​
before
string<date-time>

Cursor — returns notifications with created_at before this timestamp

​
unread_only
boolean
default:false

When true, returns only unread notifications

Response

Notifications returned

​
success
boolean
​
status
integer
​
data
object[]