---
title: "List webhook endpoints"
method: GET
path: "/webhooks/endpoints"
tags: ["webhooks"]
---

# List webhook endpoints

`GET /webhooks/endpoints`

## Request

- Base URL: `/api/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/webhooks/endpoints`
- Auth: API key in header `X-Axilio-Api-Key`
- TypeScript: <https://skmtc.dev/axilioai/apis/axilio-api/docs/webhooks/endpoints/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists every webhook endpoint registered for the caller's organization. The collection is bounded, so it is returned whole rather than paged. Signing secrets are never included.

## Response `200`

OK

- WebhookEndpointListResponse: The organization's registered webhook endpoints (the complete set, not a page).
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `endpoints` WebhookEndpoint[], nullable, required: Registered endpoints.
    - `$schema` string, uri: A URL to the JSON Schema for this object.
    - `config` object: Non-secret configuration of a BYOS destination (e.g. queue_url + region). Absent for webhook destinations.
    - `created_at` string, date-time, required: Timestamp when the endpoint was registered.
    - `disabled` boolean, required: True once delivery has been suspended for a persistently failing endpoint.
    - `event_types` string[], nullable, required: Subscribed event types ("*" means all).
    - `id` string, required: Endpoint identifier.
    - `type` 'webhook' | 'aws_sqs' | 'aws_s3' | 'aws_kinesis', required: Destination type: webhook or a BYOS type (aws_sqs, aws_s3, aws_kinesis).
    - `url` string: Delivery endpoint URL (webhook destinations).

## Other responses

- `default`: Error

## Changes

- **2026-09-27** `7abfd1e84b24`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/axilioai/apis/axilio-api/changes/webhooks/endpoints/get.md)

---

[API](https://skmtc.dev/axilioai/apis/axilio-api.md) - [All operations](https://skmtc.dev/axilioai/apis/axilio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/axilioai/apis/axilio-api/revisions/80de09d0e643?raw)