Jobs
Humanitarian job listings (reliefweb.int/jobs) tagged with type, career_categories, experience, theme, country, city, and source, plus application instructions in how_to_apply and closing dates in date.closing.
- Endpoint:
POSTorGET https://api.reliefweb.int/v2/jobs - Single job:
GET https://api.reliefweb.int/v2/jobs/{id|uuid}
Defaults
Requests to /v2/jobs default to profile=minimal and preset=minimal. Single-record requests (/v2/jobs/{id}) default to profile=default and preset=minimal. See Choose fields and presets.
Profiles
| Profile | Fields |
|---|---|
minimal |
title
|
list |
title, url, date.created, date.closing, status, country.name, source.name
|
full |
All fields |
default |
All fields |
Add more with fields.include.
Presets
| Preset | Status filter | Sort | Default query fields |
|---|---|---|---|
minimal |
published |
n/a | title |
latest |
published |
date.created:desc |
title, body, career_categories, country, how_to_apply, source, theme |
analysis |
published, expired |
n/a | title, body, career_categories, country, how_to_apply, source, status, theme |
Available fields
| Name | Description | Type | Attributes |
|---|---|---|---|
body |
Description of job in Markdown format | string | searchable |
body-html |
Description of job in HTML format | string | |
career_categories |
Shortcut for career categories - defaults to career_categories.name | string | searchable facetable exact multi common |
career_categories.id |
Id for career categories used by ReliefWeb | integer | searchable facetable |
career_categories.name |
Link for values | string | searchable facetable exact |
city |
Shortcut for city - defaults to city.name | string | searchable facetable exact multi common |
city.id |
Id of city used by ReliefWeb | integer | searchable facetable |
city.name |
Name of city in English | string | searchable facetable exact |
country |
Shortcut for country - defaults to country.name | string | searchable facetable exact multi common |
country.id |
Id for country used by ReliefWeb | integer | searchable facetable |
country.iso3 |
ISO 3166-1 alpha-3 code | string | searchable facetable exact |
country.name |
Name of country in English | string | searchable facetable exact |
country.primary |
Flag to indicate this is the primary country | boolean | |
country.shortname |
Short name of country where applicable, for example 'Syria' for 'Syrian Arab Republic' | string | searchable facetable exact |
date |
Shortcut for date - defaults to date.created | object | facetable |
date.changed |
Date entry modified on ReliefWeb (ISO 8601) | date | sortable facetable |
date.closing |
Date job closes to applicants (ISO 8601) | date | sortable facetable |
date.created |
Date entry created on ReliefWeb (ISO 8601) | date | sortable facetable |
experience |
Shortcut for experience requirement - defaults to experience.name | string | searchable facetable exact multi common |
experience.id |
Id for experience requirement used by ReliefWeb | integer | searchable facetable |
experience.name |
Link for values. | string | searchable facetable exact |
file |
Shortcut for file attachment - defaults to file.id | array | multi |
file.description |
Description of the file attachment | string | searchable |
file.filename |
File name of the attachment | string | |
file.id |
Id for file attachment used by ReliefWeb | integer | searchable |
file.mimetype |
MIME type of the file attachment | string | |
file.url |
URL of the file attachment | string | |
how_to_apply |
Application instructions for the job in Markdown format | string | searchable |
how_to_apply-html |
Application instructions for the job in HTML format | string | |
id |
Unique id of job used by ReliefWeb | integer | searchable sortable |
language |
Shortcut for language - defaults to language.name | string | searchable facetable exact multi common |
language.code |
ISO 639-1 code of the language the entry is written in | string | searchable facetable exact |
language.id |
Id for language of report used by ReliefWeb | integer | facetable |
language.name |
Language the report is written in - Link for values. | string | searchable facetable exact |
redirects |
Previous URL aliases that redirect to this item | string | searchable |
source |
Shortcut for source - defaults to source.name | string | searchable facetable exact multi common |
source.homepage |
URL of the source's primary website | string | searchable |
source.id |
Id for source used by ReliefWeb | integer | searchable facetable exact |
source.longname |
Official name of the source if different from source.name | string | searchable facetable exact |
source.name |
Common name of source | string | searchable facetable exact |
source.shortname |
Short name of the source, typically an acronym e.g. UNICEF | string | searchable facetable exact |
source.spanish_name |
Spanish name of the source | string | searchable facetable exact |
source.type |
Shortcut for source type - defaults to source.type.name | array | facetable exact common |
source.type.id |
Id for source type used by ReliefWeb | integer | searchable facetable |
source.type.name |
Link for values | string | searchable facetable exact |
status |
Whether job is still current | string | searchable facetable |
theme |
Shortcut for theme - defaults to theme.name | string | searchable facetable exact multi common |
theme.id |
Id for theme used by ReliefWeb | integer | searchable facetable |
theme.name |
Link for values | string | searchable facetable exact |
title |
Job title | string | searchable sortable exact |
type |
Shortcut for type - defaults to type.name | string | searchable facetable exact multi common |
type.id |
Id for job type used by ReliefWeb | integer | searchable facetable |
type.name |
Link for values | string | searchable facetable exact |
url |
Canonical url | string | |
url_alias |
Friendly' url of the job | string | searchable |
uuid |
UUID of the document or term | string | searchable |