API Reference
Become a partner

Read company positions

post
https://api.hibob.com/v1/objects/position/search

This endpoint returns a list of company positions filtered by the specified attributes. Note that this endpoint requires body parameters, which is why it is implemented as a POST request.



Required permissions
To access the positions, the service user making the call must have the following permissions:
Features > Workforce planning > Position management > Manage positions.

Body Params
fields
array of strings
required

Array of field IDs to fetch for the positions. A list of the supported field IDs can be found in the '200 response' body detailed below. To find out the field ID of a custom field, use the Get all positions fields metadata endpoint.
The array can contain 1 to 50 field IDs. Any invalid number of fields will get a response of 400 HTTP error.

fields*
filters
array of objects
required

An array of filtering conditions.

filters*
boolean
Defaults to false

Whether to include the additional "humanReadable" entry in the response.

Responses

Updated 9 months ago

Language
Credentials
Basic
base64
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 9 months ago