Skip to content

One job

GET /v1/jobs/{id}

Returns one job, including closed ones (status: "closed" with closed_at). An unknown or malformed id is a 404. Ids are Backspin’s own, bsj_ followed by lowercase letters and digits, and never change.

Every field is in the API reference. Illustrative values:

{
"id": "bsj_8f3k2m9q",
"status": "open",
"title": "Fire Alarm Technician",
"company": { "name": "Pye-Barker Fire & Safety", "domain": "pyebarkerfs.com" },
"description_html": "<p>…</p>",
"apply_url": "https://pyebarkerfire.wd1.myworkdayjobs.com/en-US/PB_V2/job/…",
"locations": [
{ "text": "Denver, CO", "city": "Denver", "region": "CO", "country": "US" }
],
"workplace": { "value": "onsite", "from": "ats" },
"employment_type": { "value": "full_time", "from": "ats" },
"pay": {
"min": 32, "max": 42, "currency": "USD", "period": "hour",
"from": "ats", "period_from": "ats", "text": null
},
"flags": { "commission_only": false, "door_to_door": false, "retail_sales": false },
"department": "Service",
"seniority": null,
"categories": ["electrical"],
"metros": ["denver"],
"posted_at": "2026-10-28T14:02:00Z",
"first_seen_at": "2026-10-28T18:00:00Z",
"updated_at": "2026-10-30T06:00:00Z",
"closed_at": null,
"source": { "platform": "workday", "job_id": "JR113627" }
}
  • from says where a value came from: ats (the employer’s own field), title, location, description, or amount (a pay period judged from the size of the amounts).
  • Unknown is null. workplace, employment_type and pay are always objects; when nothing is known their members are null.
  • Pay comes whole from one side, never mixed. When it was read from the description, text is the exact text it came from.
  • flags are true when the job’s own text says so. false means not stated, not stated otherwise.
  • apply_url is the employer’s job page. Boards link out; Backspin never takes applications.
  • description_html is the employer’s HTML as published. Sanitize it before you render it.
  • updated_at moves only when the listing itself changes.
  • company.domain is filled once Backspin knows it; most are empty today.