Create a batch job (asynchronous) — requires Pro or higher

For volumes above a synchronous call's limit: Pro up to 10,000 rows per job, Enterprise up to 1,000,000. Types: reverse, datavask (variant adresser or adgangsadresser), bbr (variant bygninger or enheder) and dagi — the same elements and the same result per element as the synchronous batch endpoints. Send JSON {type, input: [...]}, or raw CSV/TSV/NDJSON with ?type=. Responds 202 with the job; follow it with GET /v1/jobs/{id} (the dashboard's Jobs page shows the progress live). Billed as one lookup per element that returned a result — rows that fail, and the create call itself, cost nothing. If the quota runs out on the way, the job stops with status kvote_stop, and the partial result can be downloaded. Enterprise jobs run before Pro jobs.

POST/v1/jobsPro

Authentication

Authorizationstringheaderrequired

Your API key as a Bearer token.

Parameters

typestringquery

Job type — only for raw CSV/TSV/NDJSON (with JSON it goes in the body).

Allowed values:reversedatavaskbbrdagi

variantstringquery

datavask: adresser (default) or adgangsadresser · bbr: bygninger (default) or enheder.

navnstringquery

Optional name for the job (shown in the dashboard).

max 200 characters

formatstringquery

Input format, if Content-Type does not say it.

Allowed values:csvtsvndjson

Body

application/json

datastring

Raw CSV/TSV/NDJSON as text (instead of input).

navnstring

max 200 characters

typeenum<string>required

Allowed values:reversedatavaskbbrdagi

inputany[]

The elements — same shape as the synchronous batch endpoints (points, address strings, ids or lookups).

formatenum<string>

Allowed values:csvtsvndjson

variantstring

Request

curl --request POST \
  --url "https://api.danskadresseapi.dk/v1/jobs" \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "type": "reverse"
}'

Try it

API keyUsed only for this request and remembered only in this tab. It is never logged.type · queryvariant · querynavn · queryformat · queryBody (JSON)

POST https://api.danskadresseapi.dk/v1/jobs

Response

application/json

The job has been created and is queued

idstring<uuid>

fejlinteger

Elements with an error in the result (e.g. parse_failed or not found).

navnstring | null

typeenum<string>

Allowed values:reversedatavaskbbrdagieksport

kildeenum<string>

Allowed values:apidashboardeksport

totalinteger

pausetstring<date-time> | null

When the job was paused (status pauset only).

statusenum<string>

koe = waiting · koerer = running · pauset = paused · faerdig = done · fejlet = failed · annulleret = cancelled · kvote_stop = the quota ran out on the way · udloebet = the result has been deleted.

Allowed values:koekoererpausetfaerdigfejletannulleretkvote_stopudloebet

Show all 25 fieldsShow fewer

eta_sekinteger | null

Expected time remaining in seconds (only while the job is running).

faerdigstring<date-time> | null

procentnumber

startetstring<date-time> | null

variantstring

datavask: adresser | adgangsadresser · bbr: bygninger | enheder · otherwise standard.

advarselstring

Only on creation: the quota does not cover the whole job.

job_fejlobject | null

Why the job stopped (status fejlet or kvote_stop) — null when the job wasn't stopped by an error. Internal errors only show the code intern_fejl and a reference (never technical details).

Show child attributes(7)

job_fejl.kodeenum<string>

Allowed values:ingen_noegleplan_uden_adgangkonto_suspenderetkvote_opbrugtoverforbrugsloftinput_manglerfor_mange_forsoegintern_fejl

job_fejl.titelstring

job_fejl.beskedstring

Explanation in Danish (e.g. «Jobbet stoppede ved række 31.204 af 100.000, fordi teamets kvote blev brugt op …» — the job stopped at row 31,204 of 100,000 because the team's quota was used up).

job_fejl.detaljerobject

E.g. behandlet, total, del, forsoeg.

job_fejl.referencestring | null

Error reference for support.

job_fejl.tidspunktstring<date-time> | null

job_fejl.handlingerenum<string>[]

oprettetstring<date-time>

resultatobject | null

Links to the result, when there is one.

Show child attributes(2)

resultat.csvstring

resultat.ndjsonstring

udloeberstring<date-time> | null

When the result is deleted (Pro 7 days, Enterprise 30 days after completion).

behandletinteger

fejlbeskedstring | null

raekke_fejlobject

Only in GET /v1/jobs/{id}: rows with errors (and warnings) per reason.

Show child attributes(4)

raekke_fejl.totalinteger

raekke_fejl.advarslerobject

E.g. intet_match, flere_mulige.

Show child attributes(2)

raekke_fejl.advarsler.totalinteger

raekke_fejl.advarsler.pr_aarsagobject

raekke_fejl.pr_aarsagobject

E.g. { "ikke_tolket": 280, "ukendt_id": 32 }.

raekke_fejl.daekket_raekkerinteger

Number of rows the count covers.

raekker_pr_seknumber | null

Measured speed over the last 15 seconds.

afregnede_opslaginteger

Lookups counted against the quota so far — one per row that returned a result (rows with errors and the create call itself cost nothing).

venter_paa_kapacitetboolean

true while a running job waits with its next part because the API is busy — jobs give way to synchronous calls (Enterprise jobs only wait at a higher load).

venter_kapacitet_sidenstring<date-time> | null

202Eksempel

{
  "id": "00000000-0000-0000-0000-000000000000",
  "fejl": 0,
  "navn": "…",
  "type": "reverse",
  "kilde": "api",
  "total": 0,
  "pauset": "2026-09-20T10:00:00.000Z",
  "status": "koe",
  "eta_sek": 0,
  "faerdig": "2026-09-20T10:00:00.000Z",
  "procent": 0,
  "startet": "2026-09-20T10:00:00.000Z"
}

401Missing key

{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key."
  }
}