---
title: "Get the details of a single job ad"
method: GET
path: "/hiring/job-ads/{id}"
tags: ["Job ads"]
---

# Get the details of a single job ad

`GET /hiring/job-ads/{id}`

Returns the details of the job ad that was promoted on the Bob careers page. <br /><br /> To learn more about the Hiring API and how to integrate with your career page, see <a href="https://apidocs.hibob.com/docs/how-to-use-hiring-api-careers-page" target="_blank">How to integrate with your careers page</a>. <br /><br /> <p><b>Testing notes</b>:</p> <ul>
  <li>Use the testing widget's <b>Try It!</b> option to test this endpoint.</li>
</ul>

## Path parameters

- `id` string, required

## Query parameters

- `preferredLanguage` string

## Response `200`

The detailed structure of the job ad details being returned in the response body.

- JobAd
  - `/jobAd/id` object — This is the backend-id of the job ad. <br><br> <b>Note</b>: 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}".<br> 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. <br> To obtain the available departments, call the <a href="https://apidocs.hibob.com/reference/get_company-named-lists-listname" target="_blank">Get all company lists Metadata API</a> 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. <br> To obtain the available employment types, call the <a href="https://apidocs.hibob.com/reference/get_company-named-lists-listname" target="_blank">Get all company lists Metadata API</a> 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.<br> To obtain the available sites, call the <a href="https://apidocs.hibob.com/reference/get_company-named-lists-listname" target="_blank">Get all company lists Metadata API</a> 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. <br> To obtain the available sites, call the <a href="https://apidocs.hibob.com/reference/get_company-named-lists-listname" target="_blank">Get all company lists Metadata API</a> 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. <br> To obtain the available languages, call the <a href="https://apidocs.hibob.com/reference/get_company-named-lists-listname" target="_blank">Get all company lists Metadata API</a> 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"). <br> To obtain the available workspace types, call the <a href="https://apidocs.hibob.com/reference/get_company-named-lists-listname" target="_blank">Get all company lists Metadata API</a> 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/revisions/0781ebbdda91/schema)