---
title: "List webhook deliveries"
method: GET
path: "/v1/accounts/{accountId}/webhooks"
tags: ["Webhooks"]
---

# List webhook deliveries

`GET /v1/accounts/{accountId}/webhooks`

## Request

- Base URL: `https://api.assinafy.com.br`
- URL: `https://api.assinafy.com.br/v1/accounts/{accountId}/webhooks`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`

Retrieve the delivery history for webhooks sent to the account's endpoints — use it to monitor status, debug failures, and verify payloads. Pagination is returned in the `X-Pagination-*` response headers. Requires the `documents:read` OAuth scope.

[Copy as Markdown](https://api.assinafy.com.br/v1/docs/markdown?method=get&path=%2Fv1%2Faccounts%2F%7BaccountId%7D%2Fwebhooks) [Open in ChatGPT](https://chatgpt.com/?q=Read%20the%20API%20documentation%20at%20https%3A%2F%2Fapi.assinafy.com.br%2Fv1%2Fdocs%2Fmarkdown%3Fmethod%3Dget%26path%3D%252Fv1%252Faccounts%252F%257BaccountId%257D%252Fwebhooks%20and%20help%20me%20integrate%20this%20endpoint.) [Open in Claude](https://claude.ai/new?q=Read%20the%20API%20documentation%20at%20https%3A%2F%2Fapi.assinafy.com.br%2Fv1%2Fdocs%2Fmarkdown%3Fmethod%3Dget%26path%3D%252Fv1%252Faccounts%252F%257BaccountId%257D%252Fwebhooks%20and%20help%20me%20integrate%20this%20endpoint.)

## Path parameters

- `accountId` string, required

## Query parameters

- `endpoint_id` string
- `event` string
- `delivered` 'true' | 'false'
- `from` integer
- `to` integer
- `page` integer
- `per-page` integer

## Response `200`

Delivery history

- object: Standard success wrapper. Operations add their own `data`.
  - `status` integer: HTTP status code, mirrored in the body.
  - `message` string: Human-readable message; empty on success.
  - `data` WebhookDispatch[]
    - `resource` string: Always `activity_dispatching_history` in single-resource responses.
    - `id` string: Dispatch entry ID.
    - `event` string: Event type that triggered the dispatch.
    - `activity_id` integer: Internal activity ID associated with the dispatch.
    - `endpoint_id` string, nullable: ID of the webhook endpoint the delivery was sent to (`null` once that endpoint is deleted).
    - `endpoint` string, nullable: URL that received the request.
    - `payload` object, nullable: JSON payload sent to the endpoint.
    - `delivered` boolean: Whether delivery succeeded.
    - `http_status` integer, nullable: HTTP status returned (null if connection failed).
    - `response_body` string, nullable: Endpoint response body, truncated to 2000 chars.
    - `error` string, nullable: Delivery error message, if any.
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `401`: Missing or invalid credentials.
- `500`: Unexpected server error.

## Changes

- **2026-10-06** `f231647afa04`: 2 info
  - added the new optional `query` request parameter `endpoint_id`
  - added the optional property `allOf[subschema #2]/data/items/endpoint_id` to the response with the `200` status

[Operation history](https://skmtc.dev/assinafy/apis/assinafy-api-reference/changes/v1/accounts/:accountId/webhooks/get.md)

---

[API](https://skmtc.dev/assinafy/apis/assinafy-api-reference.md) - [All operations](https://skmtc.dev/assinafy/apis/assinafy-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/assinafy/apis/assinafy-api-reference/revisions/f7da81a5567e?raw)
