Skip to main content

Get Webhook History

GET
API for querying Webhook call history. Use this API to check Webhook execution status and call results. Call history includes Webhook event success/failure status and detailed information for each call.

🚧 History data is retained for 7 days

Only Webhook call history from the last 7 days is retained. Once an entry passes 7 days, it is deleted in full - including eventMessage - and cannot be recovered, so you must query the history you need within that period.

Path Parameters
chainstringrequired
Parameter specifying the target chain to query.
networkstringrequired
Parameter specifying the network of the target chain.
Query Parameters
subscriptionIdstringrequired
Parameter that specifies the subscriptionId assigned to the Webhook to query. Use the subscriptionId returned when creating the Webhook to query, update, or delete Webhook information. Enter an empty value to query all Webhook information.
pagestring
Specifies the page to query. Default is 1.
rppstring
Specifies the number of events to query per page. Value range is 1 to 100. Default is 10.
withEventMessageboolean
Specifies whether to include event messages in the query. Default is false.
statusstring
Filters events by webhook call success (SUCCESS) or failure (FAIL).
startAtstring
Specifies the start time for event occurrence in ISO 8601 format.
endAtstring
Specifies the end time for event occurrence in ISO 8601 format.
startSequenceNumberstring
Specifies the sequenceNumber to start the query from.
Responses
totalnumber
Total number of events matching the criteria.
pagenumber
Current page number of the query.
rppnumber
Number of events per page returned based on the request.
Array containing call history data.
idstring
Unique value identifying the call history entry.
compositeKeystring
Value combining subscriptionId and sequenceNumber. (Format: {subscriptionId}:{sequenceNumber})
subscriptionIdstring
Field representing the subscriptionId of the Webhook this call history entry belongs to.
sequenceNumberstring
Field representing the sequence number of the Webhook message. Compare the sequenceNumber of received messages to identify missing messages.
statusstring
Field representing whether the Webhook call succeeded (SUCCESS) or failed (FAIL).
updatedAtstring
Indicates when there was a change in the webhook delivery result (status), e.g., when a failed delivery was retried and changed to success. This field is returned in ISO 8601 format.
createdAtstring
Indicates when the webhook event occurred and the log was created. This field is returned in ISO 8601 format.
Field representing the message body delivered via Webhook. Included only when withEventMessage is set to true in the request, and not returned for entries past the 7-day retention period.
subscriptionIdstring
Field representing the subscriptionId of the Webhook the message was delivered to.
sequenceNumberstring
Field representing the sequence number of the message.
eventTypestring
Field representing the event type subscribed to by this Webhook. (e.g., ADDRESS_ACTIVITY, TOKEN_TRANSFER, LOG, ...)
protocolstring
Field representing the chain subscribed to via this Webhook. (e.g., ethereum, polygon, kaia, ...)
networkstring
Field representing the network subscribed to via this Webhook. (e.g., mainnet, sepolia, ...)
Field representing the details of the detected event. The structure varies by eventType.
reorgRemovedboolean
Field that indicates whether the message resulted from a reorg. When a reorg occurs, the message is sent with this field added and set to true. It uses the same Sequence Number as the message containing the data of the affected block, so you can tell which block's data was reorged by its Sequence Number.
codestringrequired
Code identifying the cause of the failed request.
messagestringrequired
Detailed message including the name and value of the invalid parameter.
{
  "code": "MISSING_REQUIRED_PARAMETER",
  "message": "Missing required parameter: { PARAMETER_NAME }"
}
cURL
curl -X GET 'https://web3.nodit.io/v1/avalanche/mainnet/webhooks/history?subscriptionId=5001&page=1&rpp=10&withEventMessage=true&status=SUCCESS&startAt=2026-01-01T00%3A00%3A00Z&endAt=2026-01-01T00%3A00%3A00Z&startSequenceNumber=100' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: nodit-demo'