Opret et batch-job (asynkront)

Til mængder over et synkront kalds grænse: Pro op til 10.000 rækker pr. job, Enterprise op til 1.000.000. Typer: reverse, datavask (variant adresser eller adgangsadresser), bbr (variant bygninger eller enheder) og dagi — samme elementer og samme resultat pr. element som de synkrone batch-endpoints. Send JSON {type, input: [...]}, eller rå CSV/TSV/NDJSON med ?type=. Svarer 202 med jobbet; følg det med GET /v1/jobs/{id} (dashboardets Jobs viser fremdriften live). Afregnes som ét opslag pr. element, der gav et svar — rækker, der fejler, og selve oprettelseskaldet koster intet. Er kvoten brugt undervejs, stopper jobbet med status kvote_stop, og delresultatet kan hentes. Enterprise-jobs køres før Pro-jobs.

POST/v1/jobsPro

Godkendelse

Authorizationstringheaderpåkrævet

Din API-nøgle som Bearer-token.

Parametre

typestringquery

Jobtype — kun ved rå CSV/TSV/NDJSON (ved JSON står den i body).

Mulige værdier:reversedatavaskbbrdagi

variantstringquery

datavask: adresser (standard) eller adgangsadresser · bbr: bygninger (standard) eller enheder.

navnstringquery

Valgfrit navn på jobbet (vises i dashboardet).

højst 200 tegn

formatstringquery

Inputformat, hvis Content-Type ikke siger det.

Mulige værdier:csvtsvndjson

Indhold

application/json

datastring

Rå CSV/TSV/NDJSON som tekst (i stedet for input).

navnstring

højst 200 tegn

typeenum<string>påkrævet

Mulige værdier:reversedatavaskbbrdagi

inputany[]

Elementerne — samme form som de synkrone batch-endpoints (punkter, betegnelser, id-er eller lookups).

formatenum<string>

Mulige værdier:csvtsvndjson

variantstring

Kald

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

Prøv det

API-nøgleBruges kun til dette kald og huskes kun i denne fane. Den logges aldrig.type · queryvariant · querynavn · queryformat · queryIndhold (JSON)

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

Svar

application/json

Jobbet er oprettet og står i kø

idstring<uuid>

fejlinteger

Elementer med fejl i resultatet (fx parse_failed eller ikke fundet).

navnstring | null

typeenum<string>

Mulige værdier:reversedatavaskbbrdagieksport

kildeenum<string>

Mulige værdier:apidashboardeksport

totalinteger

pausetstring<date-time> | null

Hvornår jobbet blev sat på pause (kun status pauset).

statusenum<string>

koe = venter · koerer = i gang · pauset = sat på pause · faerdig · fejlet · annulleret · kvote_stop = kvoten blev brugt undervejs · udloebet = resultatet er slettet.

Mulige værdier:koekoererpausetfaerdigfejletannulleretkvote_stopudloebet

Vis alle 25 felterVis færre

eta_sekinteger | null

Forventet tid tilbage i sekunder (kun mens jobbet kører).

faerdigstring<date-time> | null

procentnumber

startetstring<date-time> | null

variantstring

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

advarselstring

Kun ved oprettelse: kvoten rækker ikke til hele jobbet.

job_fejlobject | null

Hvorfor jobbet stoppede (status fejlet eller kvote_stop) — null, når jobbet ikke er stoppet af en fejl. Interne fejl viser kun koden intern_fejl og en reference (aldrig tekniske detaljer).

Vis underfelter(7)

job_fejl.kodeenum<string>

Mulige værdier:ingen_noegleplan_uden_adgangkonto_suspenderetkvote_opbrugtoverforbrugsloftinput_manglerfor_mange_forsoegintern_fejl

job_fejl.titelstring

job_fejl.beskedstring

Forklaring på dansk (fx «Jobbet stoppede ved række 31.204 af 100.000, fordi teamets kvote blev brugt op …»).

job_fejl.detaljerobject

Fx behandlet, total, del, forsoeg.

job_fejl.referencestring | null

Fejlreference til support.

job_fejl.tidspunktstring<date-time> | null

job_fejl.handlingerenum<string>[]

oprettetstring<date-time>

resultatobject | null

Links til resultatet, når der er et.

Vis underfelter(2)

resultat.csvstring

resultat.ndjsonstring

udloeberstring<date-time> | null

Hvornår resultatet slettes (Pro 7 dage, Enterprise 30 dage efter afslutning).

behandletinteger

fejlbeskedstring | null

raekke_fejlobject

Kun i GET /v1/jobs/{id}: rækker med fejl (og advarsler) pr. årsag.

Vis underfelter(4)

raekke_fejl.totalinteger

raekke_fejl.advarslerobject

Fx intet_match, flere_mulige.

Vis underfelter(2)

raekke_fejl.advarsler.totalinteger

raekke_fejl.advarsler.pr_aarsagobject

raekke_fejl.pr_aarsagobject

Fx { "ikke_tolket": 280, "ukendt_id": 32 }.

raekke_fejl.daekket_raekkerinteger

Antal rækker, tællingen dækker.

raekker_pr_seknumber | null

Målt fart over de seneste 15 sekunder.

afregnede_opslaginteger

Opslag lagt til kvoten indtil nu — ét pr. række, der gav et svar (rækker med fejl og selve oprettelseskaldet koster intet).

venter_paa_kapacitetboolean

true, mens et kørende job venter med næste del, fordi API'et er travlt — jobs viger for de synkrone kald (Enterprise-job venter først ved højere belastning).

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"
}

401Manglende nøgle

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