List webhook deliveries

GET https://api.invunion.com/api/v1/webhook-deliveries Console / Firebase only Markdown

List webhook delivery attempts.

Returns delivery rows newest first, without payloads. Pagination is returned next to data, not nested inside it. Filter by status, event type, destination, or created-at range.

This route is console / Firebase only for now. Tenant API keys are not accepted.

Query parameters

Name	Type	Required
`page` Page number. Default 1. Example: 1	integer	Optional
`pageSize` Page size. Default 25, maximum 100. Example: 25	integer	Optional
`status` Filter by delivery status.	string No maximum	Optional
Allowed values`pendingdeliveringsuccessfailedexhausted`
`eventType` Filter by event type.	string Max 120	Optional
Allowed values`transaction.createdinvoice.createdinvoice.updatedinvoice.paidinvoice.partially_paidmatch.createdmatch.suggestedmatch.confirmedmatch.rejectedmatch.cancelledbank.connectedbank.disconnectedsync.completedsync.failed`
`endpointId` Filter by destination UUID. Example: 4e2deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d	string No maximum	Optional
`dateFrom` Inclusive start of created_at. Example: 2026-09-01	string No maximum	Optional
`dateTo` Inclusive end of created_at. Example: 2026-09-30	string No maximum	Optional

Errors

This operation can return the following errors in addition to generic HTTP failures.

Error	HTTP code	Description
`Missing Bearer token`	401	The Authorization header is missing or is not a Bearer token.
`Invalid token`	401	Webhook destinations and deliveries are console-only. Send a Firebase ID token. Tenant API keys are not accepted on these routes.
`Too many requests, please try again later`	429	Wait and retry. The Retry-After header is the number of seconds to wait.
`Invalid query parameters`	400	A query value failed validation. details lists field and message.
`Tenant context required`	400	The authenticated credential is not bound to a tenant.
`Internal server error`	500	Unexpected server error. The JSON body includes correlationId. Retry with backoff.

Previous: List destinations Next: Get webhook delivery

Request

Requests in the examples call https://api.invunion.com/api/v1/webhook-deliveries.

curl --request GET \
  --url https://api.invunion.com/api/v1/webhook-deliveries?page=1&pageSize=25&status=failed \
  --header 'accept: application/json' \
  --header 'authorization: Bearer FIREBASE_ID_TOKEN'

import requests

url = "https://api.invunion.com/api/v1/webhook-deliveries?page=1&pageSize=25&status=failed"
headers = {
    "Accept": "application/json",
    "Authorization": "Bearer FIREBASE_ID_TOKEN",
}
response = requests.get(url, headers=headers)
print(response.json())

require 'net/http'
require 'json'
require 'uri'

uri = URI("https://api.invunion.com/api/v1/webhook-deliveries?page=1&pageSize=25&status=failed")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Accept'] = 'application/json'
request['Authorization'] = 'Bearer FIREBASE_ID_TOKEN'
response = http.request(request)
puts response.body

const response = await fetch("https://api.invunion.com/api/v1/webhook-deliveries?page=1&pageSize=25&status=failed", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer FIREBASE_ID_TOKEN"
  },
});
const data = await response.json();

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.invunion.com/api/v1/webhook-deliveries?page=1&pageSize=25&status=failed", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer FIREBASE_ID_TOKEN")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

const response = await fetch("https://api.invunion.com/api/v1/webhook-deliveries?page=1&pageSize=25&status=failed", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer FIREBASE_ID_TOKEN"
  },
});
console.log(await response.json());

200

{
  "success": true,
  "data": [
    {
      "id": "5f3deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
      "endpointId": "4e2deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
      "endpointUrl": "https://hooks.leonescars.example/invunion",
      "eventId": "7b5deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
      "eventType": "invoice.paid",
      "status": "success",
      "attemptCount": 1,
      "maxAttempts": 8,
      "nextRetryAt": null,
      "responseStatus": 200,
      "lastError": null,
      "durationMs": 84,
      "deliveredAt": "2026-09-12T09:00:04.000Z",
      "createdAt": "2026-09-12T09:00:03.000Z"
    },
    {
      "id": "b1d05728-7e4a-43c5-0e47-54831f61d907",
      "endpointId": "4e2deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
      "endpointUrl": "https://hooks.leonescars.example/invunion",
      "eventId": "8c6deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
      "eventType": "match.created",
      "status": "success",
      "attemptCount": 1,
      "maxAttempts": 8,
      "nextRetryAt": null,
      "responseStatus": 200,
      "lastError": null,
      "durationMs": 61,
      "deliveredAt": "2026-09-12T09:00:05.000Z",
      "createdAt": "2026-09-12T09:00:04.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 25,
    "total": 2,
    "totalPages": 1
  }
}

List webhook deliveries

See also

Query parameters

Errors