---
title: "Get a webhook endpoint"
method: GET
path: "/webhooks/endpoints/{endpoint_id}"
tags: ["webhooks"]
---

# Get a webhook endpoint

`GET /webhooks/endpoints/{endpoint_id}`

## 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/{endpoint_id}`
- Auth: API key in header `X-Axilio-Api-Key`

Fetches one webhook endpoint by id. A missing or wrong-organization id returns 404.

## Path parameters

- `endpoint_id` string, required: Endpoint identifier.

## Response `200`

OK

- WebhookEndpoint: A registered webhook or BYOS endpoint.
  - `$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

- `404`: Not Found
- `422`: Unprocessable Entity
- `500`: Internal Server Error

## Changes

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

[Operation history](https://skmtc.dev/axilioai/apis/axilio-api/changes/webhooks/endpoints/:endpoint_id/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)