v1

List teamets webhooks

Teamets webhooks (højst 10) med URL, event-typer, filtre og status. Hemmeligheden vises aldrig igen. Kræver en live-nøgle (ikke en pub-nøgle); kaldet tæller ikke i kvoten.

GET/v1/webhooksPro

Godkendelse

Authorizationstringheaderpåkrævet

Din API-nøgle som Bearer-token.

Kald

curl --request GET \
  --url "https://api.danskadresseapi.dk/v1/webhooks" \
  --header "Authorization: Bearer $API_NOEGLE"
Prøv det
GET https://api.danskadresseapi.dk/v1/webhooks

Svar

application/json

Teamets webhooks

countinteger
webhooksobject[]
Vis underfelter(10)
webhooks.idstring<uuid>
webhooks.urlstring<uri>
webhooks.eventsstring[]
webhooks.secretstring

Signeringshemmeligheden — kun i svaret på oprettelsen.

webhooks.statusenum<string>
Mulige værdier:activepausedauto_disabled
webhooks.enabledboolean
webhooks.filtersobject

Valgfrie ressource-filtre. Inden for et felt er det «eller», mellem felterne «og»; tomt objekt = alle hændelser. Konto-hændelser (invoice.*, quota.*, subscription.*, job.*) filtreres aldrig. En hændelse, hvor fx kommunen ikke kan afgøres, sendes ikke, når der filtreres på kommune. Højst 5000 værdier i alt.

Vis underfelter(4)
webhooks.filters.bfe_numreinteger[]

BFE-numre (ejendomme).

webhooks.filters.postnumrestring[]

Postnumre (4 cifre), fx 2100.

webhooks.filters.adresse_idsstring<uuid>[]

Adresse- eller adgangsadresse-id’er (UUID).

webhooks.filters.kommunekoderstring[]

Kommunekoder (4 cifre), fx 0101.

webhooks.created_atstring<date-time>
webhooks.auto_disabled_atstring<date-time> | null
webhooks.consecutive_failuresinteger
200Eksempel
{
  "count": 0,
  "webhooks": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "url": "…",
      "events": [
        "…"
      ],
      "secret": "…",
      "status": "active",
      "enabled": false,
      "filters": {
        "bfe_numre": [
          0
        ],
        "postnumre": [
          "…"
        ],
        "adresse_ids": [
          "00000000-0000-0000-0000-000000000000"
        ],
        "kommunekoder": [
          "…"
        ]
      },
      "created_at": "2026-09-20T10:00:00.000Z",
      "auto_disabled_at": "2026-09-20T10:00:00.000Z",
      "consecutive_failures": 0
    }
  ]
}
401Manglende nøgle
{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key."
  }
}