Hent et job

Ét jobs status og fremdrift — det kald, du gentager, mens jobbet kører.

GEThttps://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"

Svar · eksempel200json

{
  "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.statusstring: draft, queued, running, paused, completed, failed eller cancelled. failed betyder, at jobbet blev færdigt uden en eneste række, der lykkedes.
job.progressnumber: processedRows / totalRows mellem 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.resultsAvailableboolean: false, 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.

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/jobs/job_4n8q2v7k1m9x3c5z0w6r2t8b" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Svar · eksempel200json

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