v1

Cancel a batch job

A queued or running job stops at its next part. What has already been processed (and billed) can still be downloaded.

DELETE/v1/jobs/{id}Pro

Authentication

Authorizationstringheaderrequired

Your API key as a Bearer token.

Parameters

idstringpathrequired

The job's id.

Request

curl --request DELETE \
  --url "https://api.danskadresseapi.dk/v1/jobs/<id>" \
  --header "Authorization: Bearer $API_KEY"
Try it
DELETE https://api.danskadresseapi.dk/v1/jobs/%7Bid%7D

Response

application/json

The job (status annulleret)

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
200Eksempel
{
  "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."
  }
}