--- title: "Get all active job ads from your Career page" method: POST path: "/hiring/job-ads/search" tags: ["Job ads"] --- # Get all active job ads from your Career page `POST /hiring/job-ads/search` Returns an array of active job ads as promoted on the Bob career page.

To learn more about the Hiring API and how to integrate with your career page, see How to integrate with your careers page.

Testing notes:

## Query parameters - `preferredLanguage` string ## Request body - JobAdRequest - `fields` string[], required — Array of field IDs to fetch for each job ad. You must specify at least one field. The complete list of available fields is in the 200 response body schema. - `filters` JobAdFilterInstruction[], required — Array of filters to narrow down the search results. To fetch all active job ads, use an empty array (use Postman to try this as this platform does not support and empty array).
Example of fetching all Job ads (empty array):

"filters": []

Example of filtering by department:

"filters": [
{
"fieldId": "/jobAd/departmentId",
"operator": "equals",
"values": ["Accounting"]
} ]



Note: To filter results by department, employment type, site, job ad site, or workspace type, use the respective IDs, not descriptions. Retrieve these IDs from the Metadata endpoints, detailed under the '200 response' section. - `fieldId` '/jobAd/id' | '/jobAd/title' | '/jobAd/departmentId' | '/jobAd/employmentTypeId' | '/jobAd/siteId' | '/jobAd/jobAdSiteId' | '/jobAd/workspaceTypeId' | '/jobAd/languageCode' | '/jobAd/jobOpeningId', required — The field ID to filter by. An invalid ID will return 400 HTTP error. - `operator` 'equals' | 'notEqual', required — Supported operators. Any other operator will get a response of 400 HTTP error. - `values` union[], required — List of values to compare.
An empty list willreturn 400 HTTP error. For numeric fields such as `/jobAd/jobOpeningId`, `/jobAd/siteId`, and `/jobAd/jobAdSiteId`, values may be numbers or numeric strings. - union - string - number ## Response `200` An array of job ads and their details. - JobAd[] - `/jobAd/id` object — This is the backend-id of the job ad.

Note: Use this job ID slug within the URL of the job ad page on your career page in this format "https://yourdomain.com/{job-ad-id}".
This will ensure the 'Job Detail Link' from Bob directs users to the correct job ad page on your website. - `value` string, uuid - `/jobAd/applyUrl` object — This URL links to the application form that allows new candidates to apply for the job. It is essential to use this link as your application form, to ensure that candidate details are automatically submitted to Bob. - `value` string - `/jobAd/title` object — The title of the job ad as defined on the job description used to promote the job opening. - `value` string - `/jobAd/departmentId` object — The ID of the department defined on the job opening that the job ad was created from.
To obtain the available departments, call the Get all company lists Metadata API with `department` in the listname path parameter. - `value` string - `/jobAd/department` object — The name of the department defined on the job opening that the job ad was created from. - `value` string - `/jobAd/employmentTypeId` object — The ID of the employment type defined on the job opening that the job ad was created from.
To obtain the available employment types, call the Get all company lists Metadata API with `payrollEmploymentType` in the listname path parameter. - `value` string - `/jobAd/employmentType` object — The name of the employment type defined on the job opening that the job ad was created from. - `value` string - `/jobAd/siteId` object — The ID of the site defined on the job opening that the job ad was created from. To fetch the site defined for the job ad itself, use `/jobAd/jobAdSiteId` instead.
To obtain the available sites, call the Get all company lists Metadata API with `site` in the listname path parameter. - `value` integer - `/jobAd/site` object — The name of the site defined on the job opening that the job ad was created from. To fetch the site defined for the job ad itself, use `/jobAd/jobAdSite` instead. - `value` string - `/jobAd/country` object — The county name of the site defined on the job opening that the job ad was created from. To fetch the country defined for the job ad itself, use `/jobAd/jobAdCountry` instead. - `value` string - `/jobAd/jobAdSiteId` object — The ID of the site that is defined for the job ad itself. This may differ from the site defined for the job opening, if using different multiple locations.
To obtain the available sites, call the Get all company lists Metadata API with `site` in the listname path parameter. - `value` integer - `/jobAd/jobAdSite` object — The name of the site defined on the job ad itself. This may differ from the site defined for the job opening, if using different multiple locations - `value` string - `/jobAd/jobAdCountry` object — The country name of the site defined on the job ad itself. This may differ from the country defined for the job opening, if using different multiple locations - `value` string - `/jobAd/languageCode` object — The language code of the selected language on job description used to promote the job opening.
To obtain the available languages, call the Get all company lists Metadata API with `languages` in the listname path parameter. - `value` string - `/jobAd/description` object — The job description that was used to promote the job opening to the careers page. Note that the description may include HTML code to support text formatting. Ensure it is parsed accordingly. - `value` string - `/jobAd/requirements` object — The requirements as defined on the job description used to promote the job opening. - `value` string - `/jobAd/responsibilities` object — The responsibilities as defined on the job description used to promote the job opening. - `value` string - `/jobAd/benefits` object — The benefits as defined on the job description used to promote the job opening. - `value` string - `/jobAd/workspaceTypeId` object — The ID of the workspace type defined on the job ad (e.g., "remote", "hybrid", "on_site").
To obtain the available workspace types, call the Get all company lists Metadata API with `workspaceTypes` in the listname path parameter. - `value` string - `/jobAd/workspaceType` object — The name of the workspace type defined on the job ad (e.g., "Remote", "Hybrid", "On-site"). This field supports translation based on the preferredLanguage parameter. - `value` string - `/jobAd/jobOpeningId` object — The ID of the job opening this job ad was created from. Use this to link job ads to job openings when calling the Job Openings search API. - `value` integer — The numeric ID of the related job opening. - `/jobAd/employerId` object — The ID of the employer defined on the job opening that the job ad was created from. - `value` integer - `/jobAd/employer` object — The name of the employer defined on the job opening that the job ad was created from. - `value` string - `/jobAd/workLocationIds` object — The IDs of the work locations defined on the job opening that the job ad was created from. - `value` integer[] - `/jobAd/workLocations` object — The names of the work locations defined on the job opening that the job ad was created from. - `value` string[] ## Other responses - `400` — The request contains incorrect parameters or syntax errors. Please review the request body. - `404` — The requested entry was not found. Ensure the filter criteria in the request body are correct. - `default` — Unexpected error --- [API](https://skmtc.net/hibob/apis/employee-data-api.md) · [All operations](https://skmtc.net/hibob/apis/employee-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hibob/employee-data-api/versions/0781ebbdda91/schema)