Skip to main content
GET
List job offers

Authorizations

Authorization
string
header
required

Authenticate with a Bearer token: API key, OAuth token, or session token.

Query Parameters

offset
integer | null
default:0

Records to skip for pagination. Defaults to 0.

Required range: x >= 0
limit
integer
default:100

Max records per page (1–100). Defaults to 100.

Required range: 1 <= x <= 100
job_id
string<uuid>

Only return offers for this job.

candidate_id
string<uuid>

Only return offers for this candidate record (a person on a specific job).

person_id
string<uuid>

Only return offers made to this person, across all jobs.

job_offer_status_id
string<uuid>

Only return offers in this status. Get status IDs from GET /v1/job-offers/statuses.

status_type
enum<string>

Only return offers whose status belongs to this lifecycle category: pending, accepted, rejected, or rescinded.

Available options:
pending,
accepted,
rejected,
rescinded
extended_date_after
string

Return offers extended at or after this timestamp (ISO 8601). Example: 2026-04-01T00:00:00Z.

extended_date_before
string

Return offers extended at or before this timestamp (ISO 8601). Example: 2026-04-30T23:59:59Z.

sort_by
enum<string>
default:created_at

Column to sort results by. Defaults to created_at. Offers with no value for the chosen date sort last.

  • created_at — when the offer was recorded
  • updated_at — when the offer was last changed
  • extended_date — when the offer was extended to the candidate
  • accepted_date — when the candidate accepted
  • candidate_start_date — when the candidate is expected to start
Available options:
created_at,
updated_at,
extended_date,
accepted_date,
candidate_start_date
sort_order
enum<string>
default:desc

Sort direction. Defaults to desc (newest first).

Available options:
asc,
desc

Response

Job offers fetched

success
enum<boolean>
required
Available options:
true
data
object[]
required
meta
object
required