hibob_search_positions
Search company positions by specifying fields and optional filters to retrieve matching entries, including raw IDs and readable labels for HR operations.
Instructions
Search the company's positions.
Returns one entry per matching position. Each entry has 'values' (the raw values, including the IDs needed by the update tools) and 'display' (human-readable labels).
This endpoint has no pagination, so always request only the fields you need and filter where possible in a large organization.
Args: fields: Field IDs to return (1-50). filters: Optional filter clauses combined by HiBob. include_human_readable: Include display labels alongside raw values.
Returns: str: JSON of the form {"count": int, "entries": [{"values": {...}, "display": {...}}]}, or an error message beginning with "Error:".
Examples: - "Which positions are vacant?" -> fields=['/position/id', '/position/name'], filters=[{field_id: '/position/status', operator: 'equals', values: ['vacant']}] - Don't use when: you need opening-level detail such as expected start dates (use hibob_search_position_openings).
Rate limit: 100 requests/minute.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fields | Yes | Field IDs to return, 1-50 of them, e.g. ['/position/id', '/position/name', '/position/status']. | |
| filters | No | Optional filters. Filterable fields: '/position/status', '/position/name', '/position/hasOpenRequests', '/position/id'. | |
| include_human_readable | No | Also return display labels for each value. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |