Search webhook notification logs
GET/api/v2/public/webhooks/logs
Webhook logs are stored for 14 days and are used for debugging purposes.
Searching webhook logs can help you troubleshoot issues by providing detailed information about the webhook events and their payloads. This can be crucial for diagnosing problems, verifying event delivery, and ensuring your integration is functioning correctly.
Request
Query Parameters
The facilities IDs to filter the logs.
Possible values: [shift.request.created
, shift.request.cancelled
, shift.report.created
, shift.scheduled.cancelled
, shift.scheduled
, shift.created
, shift.report.accepted-automatically
, shift.report.accepted
, shift.report.rejected
, shift.cancelled
, all
]
The event type to filter the logs.
Filters logs that happened after this date
Filters logs that happened before this date
Possible values: <= 100
Default value: 10
Pagination parameter, use to specify the quantity of records returned
Default value: 0
Pagination parameter, use to specify the number of records to skip before starting to return results
Possible values: [ASC
, DESC
]
Default value: DESC
Pagination parameter, use to specify the order of records by creation date, either 'asc' for ascending or 'desc' for descending
Responses
- 201
- 400
- 401
- 403
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
data object[]
The webhook log ID.
Id of the Facility
Possible values: [shift.request.created
, shift.request.cancelled
, shift.report.created
, shift.scheduled.cancelled
, shift.scheduled
, shift.created
, shift.report.accepted-automatically
, shift.report.accepted
, shift.report.rejected
, shift.cancelled
, all
]
The event type.
The request payload.
The received response status code when the event was sent.
The received response body when the event was sent.
The url used to dispatch the webhook.
retries objectrequired
The webhook log ID.
Id of the Facility
Possible values: [shift.request.created
, shift.request.cancelled
, shift.report.created
, shift.scheduled.cancelled
, shift.scheduled
, shift.created
, shift.report.accepted-automatically
, shift.report.accepted
, shift.report.rejected
, shift.cancelled
, all
]
The event type.
The request payload.
The received response status code when the event was sent.
The received response body when the event was sent.
The url used to dispatch the webhook.
The number indicating the attempt to resend the webhook
Possible values: [success
, failure
]
The status of the webhook, if at least a single retry succeeds the status will be success.
{
"data": [
{
"id": "fd4207f4-bfc1-4090-b0aa-8fe47f702cdd",
"facilityId": "29dd8de9-a97e-48f6-887b-0c8bb6b4191d",
"eventType": "shift.cancelled",
"requestPayload": {
"data": {
"facilityId": "8abf15a8-fc00-4662-bbe9-b96c54b5cc76"
},
"eventType": "shift.scheduled"
},
"responseStatus": 201,
"responseBody": "{\"statusCode\":201}",
"url": "https://example.com/webhook",
"retries": {
"id": "fd4207f4-bfc1-4090-b0aa-8fe47f702cdd",
"facilityId": "29dd8de9-a97e-48f6-887b-0c8bb6b4191d",
"eventType": "shift.cancelled",
"requestPayload": {
"data": {
"facilityId": "8abf15a8-fc00-4662-bbe9-b96c54b5cc76"
},
"eventType": "shift.scheduled"
},
"responseStatus": 201,
"responseBody": "{\"statusCode\":201}",
"url": "https://example.com/webhook",
"retryAttempt": 0
},
"status": "success"
}
]
}
Bad request
- application/json
- Schema
- Example (from schema)
- Request Validation
Schema
Error description
The type of error
Status code of the error
{
"message": [
"Property must be a string"
],
"error": "Bad Request",
"statusCode": 400
}
Request Validation Error
{
"message": [
"facilitiesIds must be an array",
"eventType must be one of the following values: shift.request.created, shift.request.cancelled, shift.report.created, shift.scheduled.cancelled, shift.scheduled, shift.created, shift.report.accepted-automatically, shift.report.accepted, shift.report.rejected, shift.cancelled, all",
"startDate must be RFC 3339 date",
"startDate must be a date before endDate",
"startDate must be a valid ISO 8601 date string",
"endDate must be RFC 3339 date",
"endDate must be a valid ISO 8601 date string",
"limit must not be less than 0",
"limit must not be greater than 100",
"limit must be a number conforming to the specified constraints",
"offset must be a number conforming to the specified constraints",
"offset must not be less than 0",
"sortDirection must be one of the following values: ASC, DESC"
],
"error": "Bad Request",
"statusCode": 400
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
Error description
Status code of the error
{
"message": "Unauthorized",
"statusCode": 401
}
Forbidden
- application/json
- Schema
- Example (from schema)
Schema
Error description
The type of error
Status code of the error
{
"message": "Forbidden Resource",
"error": "Forbidden",
"statusCode": 403
}