v1

latestOpenAPI 3.1.1Proprietary2026-07-26184406877.9 KB
Job catalog

Get all job roles

Returns a list of all objects of type job role.<br/> <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>

get/job-catalog/job-roles

Query parameters

limitinteger

Maximum number of job roles to return.

cursorstring

A marker representing the first item on the next page to read. Should not be provided in the first call. To learn more, see <a href="https://apidocs.hibob.com/docs/pagination" target="_blank">Pagination in Bob's API</a>.

includeHumanReadableboolean

Whether to include the additional "humanReadable" JSON node in the response.

Response

Successful response

Example response

{
  "JobRoleEntries": [
    [
      {
        "/jobRole/id": {
          "humanReadable": "12345",
          "value": 12345
        },
        "/jobRole/name": {
          "humanReadable": "Developer",
          "value": "Developer"
        },
        "/jobRole/description": {
          "humanReadable": "Responsible for coding, debugging, and deploying software",
          "value": "Responsible for coding, debugging, and deploying software"
        }
      }
    ]
  ]
}