DanskAdresseAPIv1
DAWAuse thisOur V1Beta
Account

Create an API key

Creates a key on the team. The new key inherits the calling key’s scopes — a key can never create a stronger key than itself. If the calling key is IP-locked, the new one is locked to the same addresses (or a subset you give in allowed_ips); other addresses give 403. The plain text (key) is only in this response. A pub key only works from a browser once it has allowed_origins. Requires a live key.

POST/v1/keys

Authentication

Authorizationstringheaderrequired

Your API key as a Bearer token.

Body

application/json
modeenum<string>

live for servers, pub for the browser.

default: liveAllowed values:livepub
namestringrequired
max 80 characters
allowed_ipsstring[]

Lock the key to these IP addresses (or CIDR). Calls from other addresses get 403.

max 20 items
allowed_originsstring<uri>[]

Origins a pub key may be called from, e.g. https://shop.dk. Without them every browser call is rejected (403).

max 20 items

Request

curl --request POST \
  --url "https://api.danskadresseapi.dk/v1/keys" \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "name": "Webshop (prod)"
}'
Try it
POST https://api.danskadresseapi.dk/v1/keys

Response

application/json

The key — `key` is only shown here

idstring<uuid>
keystring

The key itself in plain text. Store it now.

modeenum<string>
Allowed values:livepub
namestring
prefixstring
warningstring

Reminder to store the key.

created_atstring<date-time>
201Eksempel
{
  "id": "00000000-0000-0000-0000-000000000000",
  "key": "sk_live_…",
  "mode": "live",
  "name": "…",
  "prefix": "…",
  "warning": "…",
  "created_at": "2026-09-20T10:00:00.000Z"
}
401Missing key
{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key."
  }
}