Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

Your organization API key, available in Organisation settings.

Query Parameters

id
string
required

Unique identifier of the job (automatically generated by Collective) or Internal identifier of the job posting (provided by you when you created the job)

Response

Job successfully retrieved

jobId
string
required

Unique identifier of the job posting generated by Collective.

Example:

"cm71yqftr00000ck0bpz3hpg1"

internalJobId
string | null
required

Your job identifier, provided at creation, or null when not set.

Example:

"CLIENT-123"

jobUrl
string<uri>
required

Public URL of the job on Collective, in the form https://www.collective.work/jobs/<language>/<slug>.

Example:

"https://www.collective.work/jobs/en/full-stack-developer-paris-8rnv"

accountEmail
string<email>
required

Email of the recruiter who owns the job posting

Example:

"recruiter@example.com"

status
enum<string>
required

OPEN, PAUSED, or CLOSED. The list endpoint defaults to OPEN; use its status parameter to select other statuses. Expiration does not change the status; check isExpired.

Available options:
OPEN,
CLOSED,
PAUSED
Example:

"OPEN"

isExpired
boolean
required

Whether the expiration date is set and has passed. Expiry does not change the status.

Example:

false

expirationDate
string<date-time> | null
required

Expiration date of the job posting

Example:

"2026-11-30T22:00:00.000Z"

closedAt
string<date-time> | null
required

Date the job was closed, or null if it has not been closed.

Example:

null

createdAt
string<date-time>
required

Date the job was created

Example:

"2026-10-22T09:30:00.000Z"

title
string
required

Job title

Example:

"Full Stack Developer"

companyName
string | null
required

Name of the company

Example:

"Collective"

companyLogoUrl
string | null
required

URL of the company logo

Example:

"https://assets.collective.work/logos/collective.png"

budget
string | null
required

Daily rate or salary range for the position, or null when not set.

Example:

"600-750€/day"

isSalaryAccordingToProfile
boolean
required

Whether the salary is determined based on the candidate profile

Example:

false

contractType
enum<string>
required

The contract type for the job

Available options:
FREELANCE,
PERMANENT_CONTRACT
Example:

"FREELANCE"

location
string | null
required

Job location, as its full English name

Example:

"Paris, France"

workPreferences
enum<string>[]
required

Work arrangements accepted for the job. Responses return an array; creation and update accept a single string.

Available options:
REMOTE,
HYBRID,
ON_SITE
Example:
skills
string[]
required

Required skills for the position

Example:
language
string | null
required

Language of the job posting, such as en, fr, or es, or null when not set.

Example:

"en"

description
string | null
required

Job description (text or sanitized HTML)

Example:

"<p>We are looking for a full stack developer.</p>"

profileWanted
string | null
required

Description of the ideal candidate profile (text or sanitized HTML)

Example:

"<p>5 years of experience with TypeScript.</p>"

questions
string[]
required

Questions for applicants, in display order

Example:
requirePhoneNumber
boolean
required

Whether phone number is required for application

Example:

false

notifyByEmailForEveryApplication
boolean
required

Whether the recruiter who posted the job is notified by email for every application

Example:

false