Sign in

v1

latestOpenAPI 3.1.1Proprietary2026-07-26184406877.9 KB
Job ads

Get all active job ads from your Career page

Returns an array of active job ads as promoted on the Bob career 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> <li>Use the <b>Examples > Request Example</b> option to see how to initiate body parameters.</li> </ul>
post/hiring/job-ads/search

Query parameters

preferredLanguagestring

The job ads will be returned in the language you provide in the preferred language (if available). Otherwise, the language specified in the job ad will be used. To obtain the available language codes, call the <a href="https://apidocs.hibob.com/reference/get_company-named-lists-listname" target="_blank">Get all company lists Metadata API</a> with worldLanguages in the listname path parameter.

Request body

fieldsstring[] 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.

Example request

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

Response

An array of job ads and their details.