Job catalog

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 attributes. 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:

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.