---
title: "Get subscriptions"
method: GET
path: "/webhooks"
tags: ["14. Webhooks"]
---

# Get subscriptions

`GET /webhooks`

## Query parameters

- `prevCursor` string
- `nextCursor` string
- `maxResults` integer
- `url` string
- `headerName` string
- `headerValue` string
- `categories` string[]
- `eventTypes` string[]
- `expiresAtFrom` string, date-time
- `expiresAtTo` string, date-time
- `createdAtFrom` string, date-time
- `createdAtTo` string, date-time

## Response `200`

OK

- GetWebhooksResponse
  - `numberOfElements` integer
  - `maxResults` integer
  - `prevCursor` string
  - `nextCursor` string
  - `items` GetWebhookResponseView[]
    - `webhookId` string, uuid — The ID of the webhook.
    - `url` string — The URL of the customer's webhook listener.
    - `headers` SubscriptionHeaderView[] — Appropriate for the authentication method the customer wants Tango to use when calling their webhook listener.
      - `name` string, required — The name of the header.
      - `value` string, required — The value of the header.
    - `categories` string[] — The categories the customer wants to subscribe to.
    - `eventTypes` string[] — The event types the customer wants to subscribe to.
    - `signingCertificate` string — The public X509 certificate used to sign the webhook payload. The certificate is base64 encoded.
    - `hmacSharedSecretKey` string — The HMAC secret key used to sign the webhook payload. Required when payloadVerificationMethod is HMAC. The key must be base64 encoded.
    - `createdAt` string, date-time — The date and time the webhook was created.
    - `updatedAt` string, date-time — The date and time when the webhook was last updated.
    - `expiresAt` string, date-time — The date and time the webhook expires.
    - `payloadVerificationMethod` 'HMAC' | 'X509' | 'NONE' — Method to verify webhook payload integrity.
  - `prevPageAvailable` boolean
  - `nextPageAvailable` boolean

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/tangocard/apis/tango-api.md) · [All operations](https://skmtc.net/tangocard/apis/tango-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tangocard/tango-api/revisions/324ad9683921/schema)