> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polygon.technology/llms.txt
> Use this file to discover all available pages before exploring further.

# List webhooks

> Returns a paginated list of all webhook endpoints registered for your
organization. The `secret` field is never included in list responses.
Supports cursor-based pagination via `limit` (default 10, max 100),
`startingAfter` (cursor for the next page), and `endingBefore` (cursor
for the previous page).



## OpenAPI

````yaml /api-reference/openapi.yaml get /webhooks
openapi: 3.0.3
info:
  title: Polygon OMS Public API
  version: v26.05.28-0001
  description: >-
    Unified API for moving money between crypto and fiat. Three ways to move
    money: Transactions (instant, wallet or card funded, including Cash-In for
    in-person cash deposits), Deposit Addresses (reusable crypto deposit
    configurations), and Virtual Accounts (dedicated bank accounts that
    auto-convert fiat to crypto). Standard transactions follow a two-step flow:
    create a Quote (pricing), then create a Transaction (execution). Cash-in
    codes generate a one-time deposit code for in-person cash deposits at retail
    locations.
  contact:
    name: Polygon OMS
    url: https://oms.polygon.technology
servers:
  - url: https://sandbox-api.polygon.technology/v0.9
    description: Sandbox
  - url: https://api.polygon.technology/v0.9
    description: Production
security:
  - BearerAuth: []
tags:
  - name: Auth
    description: Authentication via FrontEgg
  - name: Customers
    description: Customer management and KYC
  - name: Customer
  - name: Wallet
  - name: Quote
  - name: Transaction
  - name: Webhook
  - name: CashIns
  - name: CashLocation
  - name: Sandbox
  - name: Simulation
paths:
  /webhooks:
    get:
      tags:
        - Webhook
      summary: List webhooks
      description: |-
        Returns a paginated list of all webhook endpoints registered for your
        organization. The `secret` field is never included in list responses.
        Supports cursor-based pagination via `limit` (default 10, max 100),
        `startingAfter` (cursor for the next page), and `endingBefore` (cursor
        for the previous page).
      operationId: listWebhooks
      parameters:
        - $ref: '#/components/parameters/PaginationParams.limit'
        - $ref: '#/components/parameters/PaginationParams.startingAfter'
        - $ref: '#/components/parameters/PaginationParams.endingBefore'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookList'
          description: The request has succeeded.
components:
  parameters:
    PaginationParams.limit:
      in: query
      name: limit
      required: false
      schema:
        format: int32
        type: integer
    PaginationParams.startingAfter:
      in: query
      name: startingAfter
      required: false
      schema:
        type: string
    PaginationParams.endingBefore:
      in: query
      name: endingBefore
      required: false
      schema:
        type: string
  schemas:
    WebhookList:
      properties:
        data:
          items:
            $ref: '#/components/schemas/Webhook'
          type: array
        hasMore:
          description: >-
            True when more rows exist beyond this page in the direction of
            travel (forward by default, backward when `endingBefore` was
            supplied).
          type: boolean
        nextCursor:
          description: |-
            Opaque cursor pointing at the last item in this page. Present when
            `data` is non-empty. Pass as `startingAfter` to fetch the next page;
            `hasMore=false` signals no more pages forward.
          type: string
        object:
          type: string
        previousCursor:
          description: >-
            Opaque cursor pointing at the first item in this page. Present when

            `data` is non-empty. Pass as `endingBefore` to page backward; when

            this yields an empty response the client is at the start of the
            list.
          type: string
      type: object
    Webhook:
      properties:
        complianceOnly:
          description: >-
            When true, this endpoint receives compliance-only events (e.g.
            underReview)

            that are excluded from all regular partner webhooks (AML
            no-tipping-off).

            Can only be set via the admin API.
          type: boolean
        createdAt:
          description: ISO 8601 UTC timestamp of when the webhook was registered.
          format: date-time
          type: string
        enabled:
          description: >-
            Whether OMS is actively delivering events to this endpoint. Set to
            `false`

            to pause deliveries without deleting the endpoint. OMS also sets
            this to

            `false` automatically if the endpoint returns `410 Gone`.
          type: boolean
        events:
          description: >-
            Event types this endpoint subscribes to. An empty array means the
            endpoint

            receives all event types (wildcard). See the event catalog in the
            webhook

            delivery documentation for the full list of valid values.
          items:
            type: string
          type: array
        id:
          description: Unique webhook identifier. Uses the `whk_` prefix.
          type: string
        object:
          description: Resource type discriminator. Always `"webhook"`.
          enum:
            - webhook
          type: string
        secret:
          description: >-
            Signing secret used to verify the `Webhook-Signature` header on
            incoming

            deliveries. Uses the `whsec_` prefix (32 cryptographically random
            bytes,

            hex-encoded). **Returned only on creation** - it cannot be retrieved

            afterward. Store it in your secrets manager immediately.
          type: string
        status:
          $ref: '#/components/schemas/WebhookStatus'
        url:
          description: HTTPS endpoint that OMS delivers event payloads to.
          type: string
      required:
        - complianceOnly
      type: object
    WebhookStatus:
      enum:
        - active
        - disabled
      type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Token from POST /auth/token

````