List Jobs
GET /services/api/v1/jobs
Returns a list of job openings.
Optional Query Parameters
Parameter | Type | Description |
---|---|---|
type_of | string | Filter jobs by their assigned status. Possible values are: ["draft", "archived", "active_published", "active_closed"]. |
created_at_since | timestamp | Only return job openings that have been created since the specified timestamp. |
updated_at_since | timestamp | Only return job openings that have been updated since the specified timestamp. |
Response
Results list.
- Example
- Schema
{
"entries": [
{
"id": "Gqzr56Z5",
"created_at": "2024-08-24T00:00:00.000Z",
"updated_at": "2024-09-12T10:18:11.940Z",
"published_at": "2024-09-06",
"reference": null,
"type_of": "active_pubished",
"unlimited_duration": true,
"valid_until": null,
"header_image_url": null,
"languages": ["en", "it"],
"title_en": "Project Manager (m/f/d)",
"title_it": "Capo progetto (m/f/d)",
"description_en": "<h3>Summary</h3>\n<p style=\"text-align: justify;\">Lorem ipsum dolor</p>"
"description_it": "<h3>Descrizione</h3>\n<p style=\"text-align: justify;\">Lorem ipsum dolor</p>"
"contact_person": "Daniela Rossi",
"contact_email": "daniela.rossi@onboard.org",
"contact_phone": "+39 1234567890",
...
},
{
"id": "Gqzr56Z5",
"created_at": "2023-05-23T03:10:15.000Z",
"updated_at": "2023-05-23T03:10:18.321Z",
"published_at": null,
"reference": null,
"type_of": "draft",
"unlimited_duration": true,
"valid_until": null,
"header_image_url": null,
"languages": ["en"],
"title_en": "Customer Support Assistant (m/f/d)",
"description_en": "<h3>Summary</h3>\n<p style=\"text-align: justify;\">Lorem ipsum dolor</p>"
"contact_person": "Daniela Rossi",
"contact_email": "daniela.rossi@onboard.org",
"contact_phone": "+39 1234567890",
...
}
],
"current_page": 1,
"per_page": 30,
"total_entries": 2
}
Attribute | Type | Description |
---|---|---|
id | string | Job id. |
created_at | timestamp | Job opening creation date. |
updated_at | timestamp | Job opening last updated at. |
published_at | date | Job opening published at. |
reference | string | Custom reference id. There is no generic pattern here and the values are decided by the company. |
type_of | string | Type of the job opening. Possible values are: ["draft", "archived", "active_published", "active_closed"]. |
unlimited_duration | boolean | Boolean depicting wether the job opening has an unlimited duration or is limited by the valid_until date. |
valid_until | timestamp | Timestamp describing how long the job opening is valid. |
header_image_url | string | Temporary URL to the header image of the job opening. |
languages | string[] | Languages the job opening is available in. These values are a subset of the business locales |
title_{locale} | string | Name of the contact person for the current job opening. |
description_{locale} | string | Name of the contact person for the current job opening. |
contact_person | string | Name of the contact person for the current job opening. |
contact_email | string | Email address of the contact person. |
contact_phone | string | Phone number of the contact person. |
applications_count | int | Count of applications that have been submitted for this job opening. |
archived_at | date | Date the job opening has been set to type_of: archived |
employment_types | string[] | Array of employment types. Possible values are: ["full_time", "part_time", "remote", "internship", "apprenticeship", "unlimited", "limited", "minor"] |
formatted_salary | string | Formatted string describing the salary of the job opening. Null if no salary has been specified. |
formatted_entry_date | string | Formatted string describing the entry date. |
public_updated_at | timestamp | Public timestamp depicting when the job opening has been last updated at. |
file_{1-6}_url | string | Temporary URL to a file for the job opening. These can be for example data protection notices or other files. |
file_{1-6}_label_{locale} | string | Label describing the file. |