Metadata

The Matadata API provides access to the details of your company resources.

Overview

The metadata in Bob represents the properties of data fields and lists. The properties include the field's type, category and id, helping you to learn how to process the data it contains.

Use the Metadata endpoints to:

  • Read fields and custom fields properties.
  • Read and update lists and list-items.
  • Read out-of-the-box table columns properties.
  • Read custom tables properties.

Learn more about using Fields and lists metadata

Notes:

  1. The Fields metadata endpoint retrieves fields and table columns representing employee data. This includes "current" data from historical tables, such as columns from the "effective" entry in the Work table.
  2. Fields returned by the Fields metadata can be accessed using the Search for employees endpoint, except for the 'Actual Payments' table, which should be accessed via the Search for actual payments endpoint.

Permissions

The service user you use for Metadata GET endpoints doesn't require any permissions.

To create new fields set Features > Settings > Employee fields > Manage Employee Field Settings.

To learn more about permissions, see Setting permissions to Service Users.

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 Onboarding endpoints.