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.
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 ↗.
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) |
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 |