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

# List webhook subscriptions

`GET /webhooks`

Get a paginated list of webhook subscriptions with optional filtering

## Query parameters

- `limit` integer
- `after` string
- `before` string
- `topic` 'payout_paid' | 'payout_failed' | 'payout_processing' | 'payout_scheduled' | 'customer_created' | 'customer_updated' | 'customer_archived' | 'payment_succeeded' | 'payment_chargeback' | 'payment_refunded' | 'invoice_paid' | 'invoice_archived' | 'invoice_created' | 'invoice_updated' | 'payment_failed' | 'payment_method_added' | 'payment_method_deleted' | 'default_payment_method_changed' | 'vendor_created' | 'vendor_updated' | 'vendor_deactivated' | 'vendor_reactivated' | 'bill_created' | 'bill_updated' | 'bill_submitted' | 'bill_rejected' | 'bill_deleted' | 'vendor_payment_processing' | 'vendor_payment_succeeded' | 'vendor_payment_failed' | 'vendor_payment_canceled' | 'vendor_data_request_submitted'
- `is_active` boolean

## Response `200`

OK

- PaginatedResponseWebhookSubscription
  - `data` WebhookSubscription[]
    - `created_at` string
    - `endpoint_url` string
    - `id` string
    - `is_active` boolean
    - `partner_id` string
    - `secret_last_4_digits` string
    - `topic` 'payout_paid' | 'payout_failed' | 'payout_processing' | 'payout_scheduled' | 'customer_created' | 'customer_updated' | 'customer_archived' | 'payment_succeeded' | 'payment_chargeback' | 'payment_refunded' | 'invoice_paid' | 'invoice_archived' | 'invoice_created' | 'invoice_updated' | 'payment_failed' | 'payment_method_added' | 'payment_method_deleted' | 'default_payment_method_changed' | 'vendor_created' | 'vendor_updated' | 'vendor_deactivated' | 'vendor_reactivated' | 'bill_created' | 'bill_updated' | 'bill_submitted' | 'bill_rejected' | 'bill_deleted' | 'vendor_payment_processing' | 'vendor_payment_succeeded' | 'vendor_payment_failed' | 'vendor_payment_canceled' | 'vendor_data_request_submitted'
    - `updated_at` string
  - `end_cursor` string
  - `has_next_page` boolean
  - `has_previous_page` boolean
  - `start_cursor` string

---

[API](https://skmtc.net/alternativepayments/apis/alternative-payments.md) · [All operations](https://skmtc.net/alternativepayments/apis/alternative-payments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alternativepayments/alternative-payments/revisions/730efda86cd1/schema)