Offer is proposed employment terms for a recipient before that recipient
becomes a worker. It preserves the terms, deadline, delivery state, decision
evidence, and downstream worker or onboarding link for that proposal.
Attributes
string
Unique identifier for the offer, e.g.
ofr_8kY3pQmNvT2sW9xF.string
The object type. Always
offer.string
Workspace ID that owns the offer.
string
Offer status. One of
draft, sent, accepted, declined, expired, or
voided.object
Recipient name and email.
object
Proposed role, employment constraints, compensations, and benefits.
Employment includes allowed types, start date, and allowed countries.
string
Position ID linked to the offer, if any.
string
Job ID linked to the offer, if any.
string
Timestamp when the offer expires.
object | null
Delivery summary for sent offers, including the candidate URL, first sent
timestamp, latest delivery email status, last sent timestamp, and resend
count.
object | null
Candidate decision summary for accepted or declined offers. Accepted
decisions include the frozen accepted
terms, selected compensation and
employment snapshots, and signer and request evidence.object | null
Document or agreement summary associated with the offer. This is
null in
v1 until the offer document or agreement integration is added. Use
decision.terms and decision.evidence for accepted-offer evidence.string | null
Worker ID created from the accepted offer, if conversion has happened.
object | null
Onboarding summary created from the accepted offer, if conversion has
happened.
object
Set of key-value pairs attached to the offer.
string
Timestamp of when the offer was created.
string
Timestamp of when the offer was last updated.