Webhook event logs

2 minute read

GET https://www.digicert.com/services/v2/webhook/{{webhook_id}}/event-logs

Use this endpoint to get a log of events sent to your webhook listener. Each entry in the event log has the following information:

Timestamp
Event type
Event data
HTTP response code returned by the webhook listener

Example requests and responses

cURL

curl --request GET 'https://www.digicert.com/services/v2/webhook/{{webhook_id}}/event-logs' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json'

200 OK

{
  "events": [
    {
      "event_name": "challenge_webhook_endpoint",
      "request_status": "success",
      "request_sent_time": "2023-07-10T18:38:35",
      "response_received_time": "2023-07-10T18:38:35",
      "response_code": 200
    },
    {
      "event_name": "order_rejected",
      "event_info": {
        "order_id": 470091052,
        "certificate_id": 471270113
      },
      "request_status": "success",
      "request_sent_time": "2023-07-14T19:09:19",
      "response_received_time": "2023-07-14T19:09:20",
      "response_code": 200
    }
  ],
  "page": {
    "total": 2,
    "limit": 1000,
    "offset": 0
  }
}

Filters and URL query parameters

This endpoint supports filters, sorting, and pagination. For general information and examples of the syntax to use when applying filters and sorting results, see Services API - Filters, sorting, and pagination parameters.

Name	Req/Opt	Type	Description
filters[`{{property_name}}`]	optional	string	Filters results by the specified property. Replace `{{property_name}}` in your request with the property to use for filtering. This endpoint supports filtering by the following properties:
offset	optional	int	Index of the first result to include in the response. Default:
0
limit	optional	int	Total number of results to include in the response. Max: 1000 (default)

Response parameters

Name	Type	Description
events	array	List of objects with information about events sent to the endpoint for your webhook listener.
.. event_name	string	Event name. Possible values: See CertCentral event types.
.. event_info	object	Object with event `data`. To see what data is sent for each event, see CertCentral event types.
.. request_status	string	Request status. Possible values: `success`, `failed`
.. request_sent_time	string	Date and time CertCentral sent the event. UTC timezone, ISO 8601 format.
.. response_received_time	string	Date and time CertCentral received a response from your webhook event listener. UTC timezone, ISO 8601 format.
.. response_code	integer	HTTP status response code CertCentral received from your webhook event listener.
page	object	Object with pagination details. Modified with URL query strings.