ManagementExperimental

List webhook deliveries

Lists the deliveries to one webhook endpoint over the last 7 days, newest first. A delivery is one event: attemptNumber counts the attempts made so far, payload is the body sent, and httpStatus and responseBody are the endpoint's answer to the latest attempt.

get/management/webhooks/{webhookEndpointReference}/deliveries

Authorization

Authorization: Bearer {token} — an OAuth2 access token from the client-credentials flow. How authentication works

Path parameters

webhookEndpointReferencestringrequired

Webhook endpoint reference, as returned by GET /management/webhooks.

Query parameters

limitinteger

Maximum number of items to return (1-100)

Default20

cursorstring

Opaque cursor token for fetching the next page. Pass the nextCursor value from a previous response.

Responses

200List of deliveriesapplication/json

Show response body

dataarray of WebhookDelivery

Show properties

eventTypestring

eventIdstring

The webhook-id header every attempt of this delivery carries.

payloadobject

The request body sent to the endpoint.

responseBodystring | null

Body the endpoint answered on the latest attempt. Null when no attempt reached it.

statusstring

pending and sending are in flight, failed will be retried at nextRetryAt, exhausted means every retry failed and no further attempt will be made.

Optionspendingsendingdeliveredfailedexhausted

attemptNumberinteger

Attempts made for this delivery so far.

httpStatusinteger | null

Status code the endpoint answered on the latest attempt. Null when no attempt reached it.

nextRetryAtstring | null · date-time

sentAtstring | null · date-time

When the latest attempt was sent.

deliveredAtstring | null · date-time

When the endpoint acknowledged the event with a 2xx.

paginationobject

Show properties

limitinteger

Maximum items per page

hasMoreboolean

Whether there are more items after this page

nextCursorstring | null

Opaque cursor token for the next page. Null when there are no more results.

400Bad request - invalid parameters 401Unauthorized - missing or invalid API key 404Resource not found 429Rate limit exceeded. A `429` can also arrive without these headers or this body; handle it by its status code.500Internal server error

Request

curl 'https://connect.firsty.app/api/v3/management/webhooks/{webhookEndpointReference}/deliveries' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

fetch('https://connect.firsty.app/api/v3/management/webhooks/{webhookEndpointReference}/deliveries', {
  headers: {
    Authorization: 'Bearer YOUR_ACCESS_TOKEN'
  }
})

requests.get(
    "https://connect.firsty.app/api/v3/management/webhooks/{webhookEndpointReference}/deliveries",
    headers={
      "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    }
)

$client = new GuzzleHttp\Client();

$response = $client->request('GET', 'https://connect.firsty.app/api/v3/management/webhooks/{webhookEndpointReference}/deliveries', [
  'headers' => [
    'Authorization' => 'Bearer YOUR_ACCESS_TOKEN'
  ]
]);

package main

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

func main() {
	requestUrl := "https://connect.firsty.app/api/v3/management/webhooks/{webhookEndpointReference}/deliveries"

	req, _ := http.NewRequest("GET", requestUrl, nil)

	req.Header.Add("Authorization", "Bearer YOUR_ACCESS_TOKEN")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://connect.firsty.app/api/v3/management/webhooks/{webhookEndpointReference}/deliveries"))
    .header("Authorization", "Bearer YOUR_ACCESS_TOKEN")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

curl 'https://connect.test.firsty.app/api/v3/management/webhooks/{webhookEndpointReference}/deliveries' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

fetch('https://connect.test.firsty.app/api/v3/management/webhooks/{webhookEndpointReference}/deliveries', {
  headers: {
    Authorization: 'Bearer YOUR_ACCESS_TOKEN'
  }
})

requests.get(
    "https://connect.test.firsty.app/api/v3/management/webhooks/{webhookEndpointReference}/deliveries",
    headers={
      "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    }
)

$client = new GuzzleHttp\Client();

$response = $client->request('GET', 'https://connect.test.firsty.app/api/v3/management/webhooks/{webhookEndpointReference}/deliveries', [
  'headers' => [
    'Authorization' => 'Bearer YOUR_ACCESS_TOKEN'
  ]
]);

package main

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

func main() {
	requestUrl := "https://connect.test.firsty.app/api/v3/management/webhooks/{webhookEndpointReference}/deliveries"

	req, _ := http.NewRequest("GET", requestUrl, nil)

	req.Header.Add("Authorization", "Bearer YOUR_ACCESS_TOKEN")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://connect.test.firsty.app/api/v3/management/webhooks/{webhookEndpointReference}/deliveries"))
    .header("Authorization", "Bearer YOUR_ACCESS_TOKEN")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response

{
  "data": [
    {
      "eventType": "package.usage.threshold",
      "eventId": "018f3a2e-7c1b-7d3a-9f0e-2b6c4d8e1a55",
      "payload": {},
      "responseBody": "string",
      "status": "delivered",
      "attemptNumber": 1,
      "httpStatus": 200,
      "nextRetryAt": "2026-01-15T09:30:00Z",
      "sentAt": "2026-01-15T09:30:00Z",
      "deliveredAt": "2026-01-15T09:30:00Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "hasMore": true,
    "nextCursor": "MjAyNC0wMS0xNVQxMDowMDowMC4wMDBaOjQy"
  }
}

{
  "type": "https://developers.firsty.app/errors/validation_failed",
  "code": "validation_failed",
  "title": "Validation failed",
  "status": 400,
  "detail": "Request contains invalid fields",
  "errors": [
    {
      "field": "planReference",
      "detail": "Must be a valid 14-character plan reference"
    }
  ]
}