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

# List webhook endpoints

`GET /api/v1/webhooks/endpoints`

Returns a paginated list of the webhook endpoints registered for your agency — an empty list when webhooks have not been enabled yet. An agency can have at most 50 endpoints. Signing secrets are never included — they are only returned when an endpoint is created.

## Query parameters

- `page` integer — Page number (1-indexed)
- `pageSize` integer — Items per page (max 100)
- `perPage` integer — Alias for pageSize

## Response `200`

List of webhook endpoints

- object
  - `status` 'ok', required
  - `data` object[], required
    - `id` string, required — Webhook endpoint ID
    - `url` string, required — Delivery URL
    - `description` string, required — Human-readable label
    - `disabled` boolean, required — Disabled endpoints receive no deliveries
    - `filterTypes` string[], nullable, required — Event types delivered to this endpoint
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `pagination` object, required
    - `page` integer, required — Current page number (1-indexed)
    - `pageSize` integer, required — Items per page
    - `total` integer, required — Total endpoints, across all pages
    - `totalPages` integer, required — Total number of pages

## Other responses

- `401` — Unauthorized - missing or invalid API key
- `422` — Validation error - the request failed schema validation (`errors.fieldErrors`) or a business rule (`errors.formErrors`)
- `429` — Too many requests - the caller has exceeded the per-agency rate limit for the tier this endpoint counts against (default per minute: 1200 read / 400 write / 60 upload). Inspect the `RateLimit-*` headers — returned on every response, not only on 429s — and back off until the window resets. See the "Rate limits" section of the introduction for details.

## Changes

- **2026-10-03** `cd4bc8bbd95e` — 1 info
  - added the optional property `error` to the response with the `422` status
- **2026-09-29** `d7ef7f970d5b` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/recruitwithatlas/apis/atlas-api/changes/api/v1/webhooks/endpoints/get.md)

---

[API](https://skmtc.dev/recruitwithatlas/apis/atlas-api.md) · [All operations](https://skmtc.dev/recruitwithatlas/apis/atlas-api/llms.txt) · [OpenAPI document](https://skmtc.dev/recruitwithatlas/apis/atlas-api/revisions/cd4bc8bbd95e?raw)