---
title: "List webhooks"
method: GET
path: "/platform/v2beta/webhooks"
tags: ["Webhooks"]
---

# List webhooks

`GET /platform/v2beta/webhooks`

## Request

- Base URL: `https://api.atlar.com`
- URL: `https://api.atlar.com/platform/v2beta/webhooks`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/atlar/apis/atlar-api-v2/docs/platform/v2beta/webhooks/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of webhooks.

## Response `200`

List of webhooks.

- object
  - `items` Webhook[], required: A list of resources.
    - `id` string, required: Unique resource identifier.
    - `organizationId` string, required: Unique resource identifier for an Organization.
    - `url` string, required: The URL to which webhooks will be sent via HTTP POST requests in JSON format. Must use scheme `https://`.
    - `filters` WebhookFilter[], required: An inclusive filter to specify which resources and events that you are interested in.
      - `resource` string, required: The API resource for which to receive webhooks. See available resources in the [Webhooks and events](doc:api#webhooks-and-events) section.
      - `eventTypes` EventType[], required: A list of event types for which to receive webhooks.
      - `apiVersion` integer, required: The API version to serialize resources as. E.g. if you are consuming events and do want to deserialize into `/payments/v2/credit-transfers`, set `apiVersion: 2`.
      - `legacyEventNames` string[]: API v1 event names. This is only for backwards compatibility with webhooks created via API v1.
    - `verified` boolean, required: Webhooks requests won't be sent if the webhook configuration is not verified (by Atlar). Modifying the URL sets verified to false. You can contact [support@atlar.com](mailto:support@atlar.com) to get a webhook configuration verified.
    - `alias` string: A human-readable name for the webhook.
    - `created` string, date-time, required: Time at which the resource was created.
    - `updated` string, date-time, required: Time at which the resource was last updated.
  - `nextToken` string, required: Pagination token for next page. The value will be a non-empty string if there are more resources to be fetched. The value will be an empty string if there are no more resources to be fetched.
  - `token` string, required: The pagination token that was used for this request. The value will be an empty string if no `token` query parameter was provided with the request.
  - `limit` integer, required: The page limit that was used for this request.

## Other responses

- `400`: Bad request.

## Changes

- **2026-11-03** `b49df1e4b3e9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/atlar/apis/atlar-api-v2/changes/platform/v2beta/webhooks/get.md)

---

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