v1

Hent én webhook

URL, event-typer, filtre og status (active, paused eller auto_disabled efter 5 opgivne leveringer i træk).

GET/v1/webhooks/{id}Pro

Godkendelse

Authorizationstringheaderpåkrævet

Din API-nøgle som Bearer-token.

Parametre

idstringpathpåkrævet

Webhookens id.

Kald

curl --request GET \
  --url "https://api.danskadresseapi.dk/v1/webhooks/<id>" \
  --header "Authorization: Bearer $API_NOEGLE"
Prøv det
GET https://api.danskadresseapi.dk/v1/webhooks/%7Bid%7D

Svar

application/json

Webhooken

idstring<uuid>
urlstring<uri>
eventsstring[]
secretstring

Signeringshemmeligheden — kun i svaret på oprettelsen.

statusenum<string>
Mulige værdier:activepausedauto_disabled
enabledboolean
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)
filters.bfe_numreinteger[]

BFE-numre (ejendomme).

filters.postnumrestring[]

Postnumre (4 cifre), fx 2100.

filters.adresse_idsstring<uuid>[]

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

filters.kommunekoderstring[]

Kommunekoder (4 cifre), fx 0101.

created_atstring<date-time>
auto_disabled_atstring<date-time> | null
consecutive_failuresinteger
200Eksempel
{
  "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."
  }
}
Hent én webhook — DanskAdresseAPI