Ulsav Docs

Notifications

GET
/api/v1/organizations/{organization_id}/notification-deliveries

Path Parameters

organization_id*string

Query Parameters

status?string

Filter by delivery status: pending, sending, sent, failed, or suppressed.

channel?string

Filter by channel: email, whatsapp, or sms.

templateKey?string

Filter by canonical template key.

subjectId?string

Filter by the order or participant the message is about.

limit?integer

Page size (1-100)

Formatint64
Range1 <= value <= 100
Default20
cursor?string

Opaque cursor from meta.nextCursor

includeTotal?boolean

Set false to omit meta.total

Defaulttrue

Response Body

OK

application/json
  1. response
$schema?string

A URL to the JSON Schema for this object.

Formaturi
data*array<>|null
meta*
Example Request
curl -X GET 'https://example.com/api/v1/organizations/string/notification-deliveries'
Example Response
{  "$schema": "https://example.com/schemas/PageNotificationDeliveryView.json",  "data": [    {      "attempts": 0,      "channel": "string",      "createdAt": "2019-08-24T14:15:22Z",      "destination": "string",      "id": "string",      "lastError": "string",      "provider": "string",      "providerMessageId": "string",      "recipientId": "string",      "recipientKind": "string",      "sentAt": "2019-08-24T14:15:22Z",      "status": "string",      "subjectId": "string",      "subjectKind": "string",      "templateKey": "string",      "updatedAt": "2019-08-24T14:15:22Z"    }  ],  "meta": {    "hasMore": true,    "limit": 0,    "nextCursor": "string",    "total": 0  }}
GET
/api/v1/organizations/{organization_id}/notification-deliveries/{delivery_id}

Path Parameters

organization_id*string
delivery_id*string

Response Body

OK

application/json
  1. response
$schema?string

A URL to the JSON Schema for this object.

Formaturi
attempts*array<>|null
channel*string
createdAt*string
Formatdate-time
destination*string

Masked destination hint; the real address is never stored.

id*string
lastError?string
provider?string
providerMessageId?string
recipientId*string
recipientKind*string
sentAt?string
Formatdate-time
status*string
subjectId*string
subjectKind*string
templateKey*string
updatedAt*string
Formatdate-time
Example Request
curl -X GET 'https://example.com/api/v1/organizations/string/notification-deliveries/string'
Example Response
{  "$schema": "https://example.com/schemas/NotificationDeliveryDetail.json",  "attempts": [    {      "attemptedAt": "2019-08-24T14:15:22Z",      "error": "string",      "errorClass": "string",      "id": "string",      "provider": "string",      "providerMessageId": "string",      "status": "string"    }  ],  "channel": "string",  "createdAt": "2019-08-24T14:15:22Z",  "destination": "string",  "id": "string",  "lastError": "string",  "provider": "string",  "providerMessageId": "string",  "recipientId": "string",  "recipientKind": "string",  "sentAt": "2019-08-24T14:15:22Z",  "status": "string",  "subjectId": "string",  "subjectKind": "string",  "templateKey": "string",  "updatedAt": "2019-08-24T14:15:22Z"}
POST
/api/v1/organizations/{organization_id}/orders/{order_id}/notifications/order-confirmation/resend

Path Parameters

organization_id*string
order_id*string

Response Body

OK

application/json
  1. response
$schema?string

A URL to the JSON Schema for this object.

Formaturi
requeued*integer
Formatint64
Example Request
curl -X POST 'https://example.com/api/v1/organizations/string/orders/string/notifications/order-confirmation/resend'
Example Response
{  "$schema": "https://example.com/schemas/ResendResult.json",  "requeued": 0}
POST
/api/v1/organizations/{organization_id}/participants/{participant_id}/notifications/pass-link/resend

Path Parameters

organization_id*string
participant_id*string

Response Body

OK

application/json
  1. response
$schema?string

A URL to the JSON Schema for this object.

Formaturi
requeued*integer
Formatint64
Example Request
curl -X POST 'https://example.com/api/v1/organizations/string/participants/string/notifications/pass-link/resend'
Example Response
{  "$schema": "https://example.com/schemas/ResendResult.json",  "requeued": 0}