Sign in

v1

latestOpenAPI 3.1.1Proprietary2026-07-26184406877.9 KB
Job catalog

Read company job profiles

This endpoint returns a list of company job profiles filtered by the specified attributes. Note that this endpoint requires body parameters, which is why it is implemented as a POST request. <br /><br /> To successfully use this endpoint, a filter is mandatory. Ensure you use the filter provided in the Example > Request example option; otherwise, the call will fail. <br /><br /> <b>Required permissions</b> <br /> The service user making the call must have the required permissions: see <a href="/reference/job-catalog#permissions-required" target="_blank">Permissions required</a>. <br /><br /> <b>Pagination</b> <br /> This endpoint uses cursor-based pagination to handle large number of table entries. To learn more, see <a href="https://apidocs.hibob.com/docs/pagination" target="_blank">Pagination in Bob's API</a>

post/job-catalog/job-profiles/search

Request body

includeHumanReadableboolean

Whether to include the additional "humanReadable" entry in the response.

Example request

{
  "filters": [
    {
      "fieldId": "/jobProfile/status",
      "operator": "equals",
      "values": [
        "active"
      ]
    }
  ]
}

Response

The job profiles returned in the response body.

Example response

{
  "JobProfileEntries": [
    [
      {
        "/jobProfile/id": {
          "humanReadable": "12345",
          "value": 12345
        },
        "/jobProfile/jobLevelRoleId": {
          "humanReadable": "12345",
          "value": 12345
        },
        "/jobProfile/jobRoleId": {
          "humanReadable": "12345",
          "value": 12345
        },
        "/jobProfile/jobFamilyId": {
          "humanReadable": "12345",
          "value": 12345
        },
        "/jobProfile/jobFamilyGroupId": {
          "humanReadable": "12345",
          "value": 12345
        },
        "/jobProfile/code": {
          "humanReadable": "J-123456789",
          "value": "J-123456789"
        },
        "/jobProfile/title": {
          "humanReadable": "Senior Developer R&D",
          "value": "Senior Developer R&D"
        },
        "/jobProfile/status": {
          "humanReadable": "Active",
          "value": "active"
        },
        "/jobProfile/description": {
          "humanReadable": "A senior software engineer.",
          "value": "A senior software engineer."
        },
        "/jobProfile/assignedEmployees": {
          "humanReadable": [
            "Audrey Darby"
          ],
          "value": [
            "3006749430876471221"
          ]
        }
      }
    ]
  ]
}