Skip to main content
GET
One open job

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
integer
required

The job id from a search

Required range: x <= 2147483647

Query Parameters

fullText
boolean
default:false

true: each job also has description, its full text. Only for accounts allowed to read it (403 otherwise).

Response

The job

id
integer
required
title
string
required
company
string
required
department
string | null
required
location
string
required

The location as the employer wrote it

workplaceType
string
required

remote, hybrid or onsite

employmentType
string | null
required
language
string
required

ISO 639-1 code of the job text; empty when unknown

countries
string[]
required

ISO 3166-1 alpha-2 codes of the job's places; empty when unknown

regions
string[]
required

English names ("Bavaria"), or as the employer wrote them when unknown

regionCodes
string[]
required

ISO 3166-2 codes of the regions ("DE-BY")

cities
string[]
required
timezones
string[]
required

IANA time zones of the job's places

latitudes
number[]
required

One point per known city, same order as longitudes

longitudes
number[]
required
agency
boolean
required

Posted by a staffing or recruiting firm

duplicateGroupId
integer | null
required

Jobs with the same value are one opening on several boards; null when the job has no duplicate

canonical
boolean
required

The job to keep of its duplicate group (the first posted); true for a job without duplicates

salary
string
required

The pay as the employer wrote it; empty when not given

salaryMin
number | null
required
salaryMax
number | null
required
salaryCurrency
string | null
required

ISO 4217

salaryPeriod
string | null
required

hour, day, week, month or year

salaryYearEur
integer | null
required

Middle of the range per year in EUR, for comparing across currencies

occupation
string | null
required

ISCO-08 code: 4 digits, or 1 to 3 when only the group is known; null when unknown

postedAt
string<date-time> | null
required

The employer's own date; null when its board gives none

firstSeenAt
string<date-time>
required
snippet
string
required

One or two sentences of the job text, without contact data

benefits
enum<string>[]
required

Benefits the job text offers, read by rules: health (health, medical, dental or vision insurance), retirement (pension, 401(k)), paid_time_off, wellness (gym, fitness, wellbeing or mental health programs). Empty when it names none of these

Available options:
health,
retirement,
paid_time_off,
wellness
visaSponsorship
boolean | null
required

Read by rules from the job text. true: it says it sponsors visas; false: it says it does not, or that candidates must already have the right to work; null: it says nothing

ats
string
required

The applicant tracking system the job is posted on

url
string<uri>
required

The job on the employer's board

applyUrl
string<uri>
required

The employer's application form

description
string

The full job text as the employer wrote it (plain text). Only with fullText=true, for accounts allowed to read it.