webhooks
List webhook delivery attempts
Delivery history across your subscriptions, newest first. Use it to see what textbee sent, what your endpoint answered, and whether a retry is pending. History is kept for subscriptions you have since deleted.
get/api/v1/webhooks/notifications
Request
- Base URL: https://api.textbee.dev
- URL: https://api.textbee.dev/api/v1/webhooks/notifications
- Auth: API key in header x-api-key
Query parameters
pagenumber
Page to return. Default 1.
limitnumber
Records per page. Default 10.
status'pending' | 'retrying' | 'delivered' | 'failed'
Only return deliveries in this state.
eventType'MESSAGE_RECEIVED' | 'MESSAGE_SENT' | 'MESSAGE_DELIVERED' | 'MESSAGE_FAILED' | 'UNKNOWN_STATE' | 'SMS_STATUS_UPDATED'
Only return deliveries for this event.
deviceIdstring
Only return deliveries for messages from this device.
startstring
Example:2026-08-01T00:00:00Z
Start of the time range, ISO 8601. Applied only together with end.
endstring
Example:2026-08-31T23:59:59Z
End of the time range, ISO 8601.
webhookSubscriptionIdstring
Only return deliveries for one subscription.
Response
A page of delivery records.
Changes
No recorded changes to this operation across all 1 revision of this API.