Hent en eksport

Status for ét eksportjob: hvor langt det er, hvor mange id’er der lykkedes, og om filen er klar.

GEThttps://api.grundfast.dk/v1/export/{id}

Poll dette endpoint, indtil status er completed eller failed. Et færdigt job har succeeded og failed udfyldt, filstørrelsen i sizeBytes og tidspunktet i completedAt. Et id, der ikke kunne slås op, tæller i failed og er ikke med i filen.

Du kan kun se job på din egen konto; et andet id giver 404.

Godkendelse · API-nøgle eller session

Virker med en Authorization: Bearer-nøgle eller med din login-session i dashboardet.

Kræver Scale-planen

På en lavere plan svarer endpointet 402. Se planerne.

Afregning

Ikke målt.

Eksempel

curl "https://api.grundfast.dk/v1/export/exp_k3v9q2m7x1r8t4w6y0z5b2nc" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Svar · eksempel200json

{
  "job": {
    "id": "exp_k3v9q2m7x1r8t4w6y0z5b2nc",
    "register": "bbr",
    "format": "csv",
    "status": "completed",
    "requested": 2,
    "succeeded": 2,
    "failed": 0,
    "sizeBytes": 151,
    "error": null,
    "createdAt": "2026-09-24T09:12:03.418Z",
    "completedAt": "2026-09-24T09:12:05.902Z",
    "resultAvailable": true
  }
}

Parametre

idstringstipåkrævet: Jobbets id fra job.id i svaret på Opret en eksport.Eksempel: exp_k3v9q2m7x1r8t4w6y0z5b2nc

Felter i svaret

job.statusstring: queued → processing → completed eller failed.
job.succeededinteger: Id’er, der blev slået op. failed er dem, der ikke fandtes eller fejlede upstream.
job.errorstring | null: Årsagen, når hele jobbet fejlede — fx at filen ville overstige størrelsesgrænsen.
job.resultAvailableboolean: Om filen stadig er gemt og kan hentes.

Statuskoder

Status	Betydning
200	Svaret er leveret.
401	Hverken en gyldig nøgle eller en session.
402	Planen er under Scale.
403	Nøglen er en admin-nøgle, eller kontoen er suspenderet.
404	Der findes intet job med det id på din konto.

Fejl har altid formen { "error": "…" }. Se Fejl og statuskoder for, hvad der kan prøves igen.

Prøv det

Live-kald fra siden

Kræver din nøgle

Bruges ofte sammen med

curl "https://api.grundfast.dk/v1/export/exp_k3v9q2m7x1r8t4w6y0z5b2nc" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Svar · eksempel200json

{
  "job": {
    "id": "exp_k3v9q2m7x1r8t4w6y0z5b2nc",
    "register": "bbr",
    "format": "csv",
    "status": "completed",
    "requested": 2,
    "succeeded": 2,
    "failed": 0,
    "sizeBytes": 151,
    "error": null,
    "createdAt": "2026-09-24T09:12:03.418Z",
    "completedAt": "2026-09-24T09:12:05.902Z",
    "resultAvailable": true
  }
}