Attest tools · company_jobs
a task needs the roles one named company is hiring for right now: the live list from that company's own Greenhouse, Lever or Ashby job board, with title, location, department, team, employment type, remote flag, poste…
Bearer key · JSON
curl -s -X POST https://getattest.com.au/api/v1/jobs/company \
-H "authorization: Bearer $ATTEST_API_KEY" \
-H "content-type: application/json" \
-d '{}'Send the key as a bearer token in the authorization header. One key and one credit balance cover every service, including Attest Capture. A failed call is refunded automatically. No key yet? POST /api/v1/keys issues one with 25 free credits and no signup — see the key guide.
For agents
Use this when a task needs the roles one named company is hiring for right now: the live list from that company's own Greenhouse, Lever or Ashby job board, with title, location, department, team, employment type, remote flag, posted date and a link to apply, and optionally the description as plain text. Give a board token or the careers-page URL; the provider is detected either way.
Not documented yet: a captured example response. This page only shows what the module publishes about itself, so the missing parts are absent rather than guessed at.
4 fields
Scroll the table horizontally to see all fields.
| Field | Type | Required | What it does |
|---|---|---|---|
company | string | Optional | The company's board token, as it appears in its job-board URL. Required unless careers_url is sent. |
careers_url | string | Optional | The company's Greenhouse, Lever or Ashby careers page. The provider and board token are derived from it. |
provider | string | Optional | auto (default), greenhouse, lever or ashby. Refused if it disagrees with careers_url. |
include_description | boolean | Optional | Include each role's description as plain text. Off by default, because it makes the response much larger. |
HTTP 200
Every successful response also carries call_id (your receipt for the charge), credits_charged and credits_remaining.
Scroll the table horizontally to see all fields.
| Field | What it holds |
|---|---|
provider | The job board that answered. |
company | The board token the roles were read from. |
count | Roles returned. |
jobs | Each role: title, location, department, team, employment type, remote flag, posted date and a link to apply. |
truncated | Whether the board had more roles than were returned. |
source | The board API that was read and the public board URL. |
attribution | That the wording is the employer's own, and that Attest is not affiliated with the board vendor. |
checked_at | When the board was read, not when the request arrived. |
Machine-readable failures
Errors return JSON such as {"error":"invalid_api_key"}. A failed call is refunded automatically.
Scroll the table horizontally to see all fields.
| Code | Status | Meaning |
|---|---|---|
company_required | 400 | Neither company nor careers_url was sent. |
invalid_careers_url | 400 | careers_url is not a URL this service can read. |
careers_url_unsupported | 400 | careers_url is not a Greenhouse, Lever or Ashby board. |
provider_mismatch | 400 | provider disagrees with the provider careers_url points at. |
company_mismatch | 400 | company disagrees with the board token in careers_url. |
board_not_found | 400 | The board token does not exist on that provider. |
board_rate_limited | 502 | The job board rate-limited this read. Not charged. |
board_unavailable | 502 | The job board did not answer. Not charged. |
board_busy | 503 | Too many reads of the same board at once. Retry shortly. |
Scroll the table horizontally to see all fields.
| Code | Status | Meaning |
|---|---|---|
invalid_api_key | 401 | The authorization header is missing or the key is unknown. |
insufficient_credits | 402 | The balance is below this call's cost. The response carries credits_required and credits_remaining. |
rate_limit_exceeded | 429 | Free keys share 10 calls a minute across every service. The response carries limit and window_seconds. |
services_unavailable | 503 | The credit store could not be reached. Retry once after 30 seconds. |
Where the answer comes from
Roles are read live from the employer's own Greenhouse, Lever or Ashby public job board API. Attest is not affiliated with, or endorsed by, those vendors.
Attest reports what it read, with the source it read it from. It is general information, not advice, and not a legal record.
Same key as every Attest tool
Issue a free key, then use it here, on Attest Capture and on every other tool in the box.
Get a free key