Hent et job
Ét jobs status og fremdrift — det kald, du gentager, mens jobbet kører.
https://api.grundfast.dk/v1/jobs/{id}processedRows vokser, efterhånden som bidder af listen bliver færdige, og progress er andelen. Når status er completed eller failed, er alle rækker behandlet. Vil du ikke spørge, så abonnér på webhook-hændelsen job.completed.
Spørg højst hvert par sekunder: et job arbejder i bidder, så tallene flytter sig i spring.
Godkendelse · API-nøgle eller session
Virker med en Authorization: Bearer-nøgle eller med din login-session i dashboardet.
Afregning
Ikke målt.
Eksempel
curl "https://api.grundfast.dk/v1/jobs/job_4n8q2v7k1m9x3c5z0w6r2t8b" \
-H "Authorization: Bearer $GRUNDFAST_API_KEY"{
"job": {
"id": "job_4n8q2v7k1m9x3c5z0w6r2t8b",
"kind": "datavask",
"status": "running",
"label": "Kundeliste oktober",
"totalRows": 2,
"processedRows": 1,
"succeeded": 1,
"failed": 0,
"billedUnits": 1,
"progress": 0.5,
"columns": { "adresse": "adresse" },
"srid": 4326,
"inputColumns": ["kunde", "adresse"],
"error": null,
"createdAt": "2026-10-05T09:12:03.418Z",
"startedAt": "2026-10-05T09:12:03.902Z",
"completedAt": null,
"updatedAt": "2026-10-05T09:12:05.117Z",
"resultsAvailable": true
}
}Parametre
idstringstipåkrævet- Jobbets id fra
job.id.Eksempel:job_4n8q2v7k1m9x3c5z0w6r2t8b
Felter i svaret
job.statusstringdraft,queued,running,paused,completed,failedellercancelled.failedbetyder, at jobbet blev færdigt uden en eneste række, der lykkedes.job.progressnumberprocessedRows / totalRowsmellem 0 og 1 — andelen af rækker, der har et svar eller en fejl.job.succeededinteger- Rækker med et svar. Kun dem faktureres (
billedUnits). job.columnsobject- Hvilke af dine kolonner jobbet læser, som rolle → kolonnenavn — angivet af dig eller genkendt ud fra navnene.
job.resultsAvailablebooleanfalse, når rækkerne er slettet efter opbevaringsperioden.
Statuskoder
| Status | Betydning |
|---|---|
| 200 | Svaret er leveret. |
| 401 | Hverken en gyldig nøgle eller en session. |
| 403 | Nøglen er en admin-nøgle, eller kontoen er suspenderet. |
| 404 | Der findes intet job med det id på din konto. |
Alle fejl har samme form. Byg logikken på type (fejlklassen) og vis message (dansk tekst med årsagen) til brugeren; hint kommer med, når vi kan se, hvad der skal rettes, og request_id er det, support skal bruge. Se Fejl og statuskoder for hver type, og hvad der kan prøves igen.
{
"error": "property not found",
"type": "not_found",
"code": "not_found",
"message": "Ressourcen findes ikke.",
"request_id": "6cbfa45a-a9ea-4140-9d42-ea752a70ff1f",
"doc_url": "https://grundfast.dk/docs/fejl#not_found"
}Prøv det
Live-kald fra siden
Kræver din nøgle