---
updatedAt: 2025-07-20T07:51:01.000Z
---

Fetch the complete documentation index at: https://apidocs.hibob.com/llms.txt. Use this file to discover all available pages before exploring further.

# Job catalog

The Job catalog API provides access to job profiles in your company.

The Job catalog in Bob is a database that details the hierarchy of all the jobs in your organization. To learn how to use the Job catalog API see [Explore Job catalog API](/docs/explore-job-catalog-api).

> 📘 Note:
>
> The new job catalog API is available only for users working with the new **Job catalog 2.0**, currently open only to new customers and customers who had not used the job catalog before February 9, 2025.  To learn more, see <a href="https://help.hibob.com/hc/en-us/articles/9032144776593" target="_blank">Getting started with the new job catalog  ↗</a>.

## What you can do with the API

* **Job Profiles**: Access the job profiles using Search with filtering options.
* **Metadata**: Each Job catalog component, such as profile, job family, family group, or role, consists of fields that can be out-of-the-box or customized. Use the API to access detailed metadata for job family groups, job families, and job roles, including available fields and custom fields. At the moment, **Job level** definition cannot be retrieved via the public API

## Permissions required

To use the Job catalog API, the service user should be granted the following permissions:

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Access component
      </th>

      <th>
        Permission
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        Job profiles
      </td>

      <td>
        Features > Job catalog > Jobs > View job profiles
      </td>
    </tr>

    <tr>
      <td>
        People assigned to profile
      </td>

      <td>
        People's Data -> People > Jobs > View selected employees' Jobs sections
      </td>
    </tr>

    <tr>
      <td>
        Job catalog settings
      </td>

      <td>
        Features > Job catalog > Jobs > View job content library.
      </td>
    </tr>

    <tr>
      <td>
        Job content library
      </td>

      <td>
        Features > Job catalog > Jobs > View job content library.
      </td>
    </tr>

    <tr>
      <td>
        Grades
      </td>

      <td>
        (Not accessible via the Pubic API at the moment)
        ~~Features > Job catalog > Jobs > View job grades in profiles~~
      </td>
    </tr>
  </tbody>
</Table>

To learn more, see [Permissions.](/reference/permissions)

## Error codes

The following error codes can be returned:

* **404 (not found)**: Indicates that Bob is using the previous version of the Job Catalog, which is not accessible via API. You should migrate to the new JobCatalog to access via the API
* **403 (forbidden)**: Indicates the service user doesn’t have the required permissions to access Job catalog.

## Rate limiting

Rate limits are restrictions that our API imposes on the number of times a user can access our endpoints within a specified period of time. To learn more about rate limiting best practices, see [Rate limiting](/reference/rate-limiting).

Below is a table detailing the rate limits for each endpoint in the Hiring endpoints.

| Method | Endpoint                                                                                 | Limit per minute |
| :----- | :--------------------------------------------------------------------------------------- | :--------------- |
| POST   | [Read company job profiles](/reference/post_job-catalog-job-profiles-search)             | 100              |
| GET    | [Get all job profiles fields](/reference/get_job-catalog-job-profiles-metadata)          | 50               |
| GET    | [Get all job role fields](/reference/get_job-catalog-job-roles-metadata)                 | 50               |
| GET    | [Get all job family fields](/reference/get_job-catalog-job-families-metadata)            | 50               |
| GET    | [Get all job family group fields](/reference/get_job-catalog-job-family-groups-metadata) | 50               |
| GET    | [Get all job roles](/reference/get_job-catalog-job-roles)                                | 50               |
| GET    | [Get all job families](/reference/get_job-catalog-job-families)                          | 50               |
| GET    | [Get all job family groups](/reference/get_job-catalog-job-family-groups)                | 50               |