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

# /webhooks

`GET /v1/webhooks`

## Request

- Base URL: `https://api.companydata.dk` (the document declares no server; this is the origin it was published from)
- URL: `https://api.companydata.dk/v1/webhooks`
- Auth: HTTP bearer

List all webhooks owned by the calling API key.

`meta.max_webhooks` shows your subscription tier's webhook limit.
Secrets are not returned — they are only available at creation time.

## Response `200`

Successful Response

- WebhooksListResponse: Response for listing webhooks.
  - `data` WebhookResponse[], required
    - `webhook_id` string, required: Unique identifier for this webhook.
    - `name` string, required: Human-readable label.
    - `url` string, required: HTTPS endpoint that receives deliveries.
    - `active` boolean, required: Whether this webhook is currently delivering events.
    - `event_types` EventType[], required: Event types this webhook receives.
    - `headers` object, required: Custom headers added to every delivery.
    - `last_success_at` string, date-time, nullable: Timestamp of the most recent successful (2xx) delivery.
    - `last_failure_at` string, date-time, nullable: Timestamp of the most recent failed delivery attempt.
    - `consecutive_failures` integer: Number of consecutive failed deliveries. Reset to 0 on the next 2xx response. Reaching 10 auto-disables the webhook.
    - `disabled_reason` string, nullable: Set when the webhook is auto-disabled. `null` otherwise.
    - `created_at` string, date-time, required: When the webhook was created.
  - `meta` object, required

---

[API](https://skmtc.dev/companydata/apis/companydata-dk-api.md) · [All operations](https://skmtc.dev/companydata/apis/companydata-dk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/companydata/apis/companydata-dk-api/revisions/1cc6c361ae64?raw)