Skip to content

Exports webhook delivery logs

Request

GET {{baseURL}}/v2/webhooks/delivery-logs/export

This endpoint exports webhook delivery logs as a CSV or JSON file.

Query parameters may be combined to filter the exported results.

See Also:
To list all available webhooks, see GET /v2/webhooks/endpoints.
To list all delivery logs, see GET /v2/webhooks/delivery-logs.
To retrieve a specified delivery log, see GET /v2/webhooks/delivery-logs/{{endpointId}}.

Security
Bearer
Query
endpointIdstring, (uuid)


Specifies the webhook identifier to retrieve.

Example:endpointId=a9b37f26-7d8e-4f9a-0b1c-2d3e4f5a6b92
eventTypestring

Filters delivery logs to a single event type.

Omit this parameter to include all event types.

Valid values are:

Wire valueMeaningGroup
api_key.createdAn API key was createdAPI Keys (affiliate only)
api_key.deletedAn API key was revoked or deletedAPI Keys (affiliate only)
invoice.createdA new invoice was createdInvoices
invoice.paidAn invoice was marked as paidInvoices
merchant.createdA new merchant account was createdMerchants (affiliate only)
payment_session.completedA payment session reached a terminal state (completed, failed, or canceled)Payment Sessions
payment_session.createdA payment session was createdPayment Sessions
quick_payment.createdA quick payment link was createdQuick Payments
quick_payment.paidA quick payment link was paidQuick Payments
settlement.batch.completedA batch settlement was processed and settledSettlement
subscription.createdA new subscription was createdSubscriptions
subscription.delinquentA subscription entered a delinquent state after repeated payment failuresSubscriptions
subscription.paidA subscription payment was successfully collectedSubscriptions
subscription.payment_failedA subscription payment attempt failedSubscriptions
terminal.addedA new terminal was registered to the accountTerminals
terminal.deactivatedA terminal was deactivated on the accountTerminals
terminal.out_of_paperA terminal paper roll is emptyTerminals
transaction.ach.cancelledAn ACH transaction was canceled before processingACH Transactions
transaction.ach.charged_backAn ACH transaction was returned or charged backACH Transactions
transaction.ach.clearedAn ACH transaction successfully clearedACH Transactions
transaction.ach.failedAn ACH transaction failed due to a processing errorACH Transactions
transaction.ach.heldAn ACH transaction was placed on hold for reviewACH Transactions
transaction.ach.in_progressAn ACH transaction was submitted to the networkACH Transactions
transaction.ach.refundedAn ACH transaction was refunded to the originatorACH Transactions
transaction.ach.scheduledAn ACH transaction was created and scheduledACH Transactions
transaction.card.authorizedA card payment authorization was approvedCard Transactions
transaction.card.capturedAn authorized card payment was capturedCard Transactions
transaction.card.declinedA card payment was declined by the issuerCard Transactions
transaction.card.failedA card payment failed due to a processing errorCard Transactions
transaction.card.refundedA card payment was refunded to the cardholderCard Transactions
transaction.card.voidedA card authorization was voided before captureCard Transactions
Enum:"api_key.created""api_key.deleted""invoice.created""invoice.paid""merchant.created""payment_session.completed""payment_session.created""quick_payment.created""quick_payment.paid""settlement.batch.completed"
Example:eventType=transaction.card.captured
deliveryLogStatusstring

Indicates the delivery success status code.

HTTP StatusMeaning
SuccessDelivery succeeded
FailureDelivery failed
Enum:"Success""Failure"
Example:deliveryLogStatus=Success
endpointHTTPResponseCodeinteger, (int32)

Specifies the HTTP response status code.

This is the HTTP status code returned by the attempted delivery.

The following is a list of HTTP response status codes that include but are not limited to:

HTTP StatusMeaning
200Delivery succeeded
400Bad request
401Unauthorized
404Endpoint not found
429Rate limited
Example:endpointHTTPResponseCode=200
dateFromstring, (date-time)

Filters returning items on or after this date (in an ISO 8601 date-time format).

If only dateFrom is specified, the search returns all available items from the dateFrom value to the present. The fields dateFrom and dateTo may be used together to create an inclusive range. We recommend creating an explicit range to avoid a potentially excessive number of returns.

Example:dateFrom=2025-01-27T12:05:54.322Z
dateTostring, (date-time)

Filters returning items on or to this date (in an ISO 8601 date-time format).

If only dateTo is specified, the search returns all available items before including the dateTo value. The fields dateFrom and dateTo may be used together to create an inclusive range. We recommend creating an explicit range to avoid a potentially excessive number of returns.

Example:dateTo=2026-02-27T12:05:54.322Z
formatstring

Specifies the data format to return the items in.

Valid values are:

ValueDescription
CsvReturns the export as a CSV file.
JsonReturns the export as a JSON file.
Default:"Csv"
Enum:"Csv""Json"
Example:format=Csv
curl -i -X GET \
  'https://sandbox.api.flute.com/v2/webhooks/delivery-logs/export?endpointId=a9b37f26-7d8e-4f9a-0b1c-2d3e4f5a6b92&eventType=transaction.card.captured&deliveryLogStatus=Success&endpointHTTPResponseCode=200&dateFrom=2025-01-27T12%3A05%3A54.322Z&dateTo=2026-02-27T12%3A05%3A54.322Z&format=Csv' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

OK

Body
string, (byte)

Indicates the returned file in the specified format.

Response
string