Reference · GET /v1/jobs/:id

Get job

Get a single job

Fetch one job by its FieldInsight ID. Returns the job object directly — the same per-job shape as an item in GET /v1/jobs, not wrapped in a `jobs` array. (GET /v1/jobs?id= returns the same job inside the array if you'd rather use the list endpoint.)

Request

curl -sS -H "Authorization: Bearer fi_pk_…" \
  https://<host>/v1/jobs/21172159

Response

{
  "id": "21172159",
  "number": "16",
  "title": "Annual service",
  "status": { "id": "68392", "name": "Tentative", "state": "pending" },
  "start_time": "2026-07-01T09:00:00+10:00",
  "customer": { "id": "245715", "name": "Acme" },
  "site": { "id": "3065756", "address": "Unit 3/24 Brand Dr…" },
  "custom_fields": { "scope_of_work": "Install" }
}

Fields

idrequired

string (path)

The FieldInsight job ID, taken from the URL path. The response carries the same fields as a List jobs item (subject to your read field-policy and custom-field map).

Errors

401 unauthorized403 no-scope404 not-found422 invalid-request429 rate-limited502 schema-drift502 upstream-scope-violation

404 covers both 'no such job' and 'this job isn't yours' — the two are indistinguishable, so existence never leaks. See List jobs for the full field reference.