DanskAdresseAPIv1
DAWAbrug denneVores V1Beta
v1

Sæt et batch-job på pause

Et job i kø eller i gang sættes på pause: den igangværende del gøres færdig og gemmes, derefter bruges ingen nye opslag. Det behandlede kan hentes. Genoptag med POST /v1/jobs/{id}/genoptag. Pausen forlænger ikke resultatets levetid.

POST/v1/jobs/{id}/pausePro

Godkendelse

Authorizationstringheaderpåkrævet

Din API-nøgle som Bearer-token.

Parametre

idstringpathpåkrævet

Jobbets id.

Kald

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

Svar

application/json

Jobbet (status pauset)

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
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"
}
401Manglende nøgle
{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key."
  }
}