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

# List webhooks

`GET /v1/webhooks`

## Request

- Base URL: `https://api.hempdata.io`
- URL: `https://api.hempdata.io/v1/webhooks`
- Auth: HTTP bearer

List all webhook subscriptions for the authenticated account.

## Response `200`

List of webhooks

- ApiResponseWebhookList
  - `success` boolean, required
  - `data` WebhookSubscription[], required
    - `id` string, uuid, required
    - `endpoint_url` string, uri, required
    - `filters` object
      - `jurisdictions` string[]
      - `substances` string[]
      - `events` string[]
    - `signing_secret` string, required: HMAC secret for verifying webhook payloads
    - `status` 'active' | 'paused' | 'failed', required
    - `created_at` string, date-time, required
  - `meta` object
    - `total` integer
  - `errors` ApiError[], nullable
    - `code` string, required: Machine-readable error code
    - `message` string, required: Human-readable error message
    - `field` string, nullable: Field that caused the error, if applicable

---

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