Custom Fields
Public API
List Custom Fields
Changed onReturns a paginated list of active custom fields. IDs are strings and each has a numeric legacyId companion for legacy integrations. Use this for active custom fields. For archived custom fields, use List Archived Custom Fields (list-archived-custom-fields) instead.
OAuth Scopes: employee:custom_fields
get/api/v1/hris/custom-fields
Request
- Base URLhttps://companySubDomain.bamboohr.com
- AuthOAuth 2Authorization code/authorize.phpToken URL/token.phpScopesemployee:custom_fields
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
pageinteger
Page number to retrieve. Must be greater than or equal to 1.
pageSizeinteger
Maximum number of custom fields to return per page.
Response
Paginated list of active custom fields.
Example response
{
"meta": {
"pageSize": 100,
"totalPages": 1,
"totalItems": 10
},
"_links": {
"next": {
"href": "/api/v1/reference-resources?page=2&pageSize=100"
},
"prev": {
"href": "/api/v1/reference-resources?page=0&pageSize=100"
}
}
}Changes
- info
endpoint added
- info