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.

📘
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 Getting started with the new job catalog ↗.

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:

Access component	Permission
Job profiles	Features > Job catalog > Jobs > View job profiles
People assigned to profile	People's Data -> People > Jobs > View selected employees' Jobs sections
Job catalog settings	Features > Job catalog > Jobs > View job content library.
Job content library	Features > Job catalog > Jobs > View job content library.
Grades	(Not accessible via the Pubic API at the moment) ~~Features > Job catalog > Jobs > View job grades in profiles~~

To learn more, see 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.

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	100
GET	Get all job profiles fields	50
GET	Get all job role fields	50
GET	Get all job family fields	50
GET	Get all job family group fields	50
GET	Get all job roles	50
GET	Get all job families	50
GET	Get all job family groups	50