COPS
Brand API

List notification deliveries

GET
/notifications/deliveries

List recent notification sends, newest first, with status, attempts and error. Use it to find out if notifications were sent or why they failed. Filter by subscription, status or time.

Authorization

apiKeyAuth
headerx-api-key<token>

API key for authentication. Keys are prefixed with cops_.

Query Parameters

subscriptionId?string

Only deliveries to this subscription.

Match^nsub_.+[\s\S]*$
status?string

pending: waiting for its first or next attempt. sent: the destination accepted it. failed: no attempts left.

Value in"pending""sent""failed"
since?string

Only deliveries created at or after this ISO 8601 time.

Formatdate-time
limit?integer

Maximum number of deliveries to return.

Range1 <= value <= 50
Default20

Response Body

Response schema unavailable.

Example Request
curl -X GET 'https://cops.app/api/brand/notifications/deliveries'
Example Response200
Empty

Send test notification POST

Send one test notification to a subscription's destination now and record the result as a delivery. Use it to check that a webhook or email address works, or to see how an event, such as the daily digest, looks. Pass idempotencyKey so a retry does not send twice.

Get notification delivery GET

Get one notification send by id: status (pending, sent, failed), attempts, HTTP status and error. Use it after send_test_notification to confirm the result.