API Reference
Become a partner

Search employers

post
https://api.hibob.com/v1/employers/search

Search and page through the company's employers using the flattened field contract.

Body Params

Request body for employer search. filters is required — send an empty array
([]) to return every employer the caller can view. fields is optional;
omit it to return all available fields. limit defaults to 50.

Request body for employer search. filters is required — send an empty array
([]) to return every employer the caller can view. fields is optional;
omit it to return all available fields. limit defaults to 50.

fields
array of strings | null
Defaults to /employer/id,/employer/legalName,/employer/country,/employer/employerStatus

Field IDs to include in each result item. When omitted, all available
fields are returned. Discover the authoritative field catalog (including
custom fields) via the employer metadata search endpoint; out-of-the-box
field IDs are also listed as keys on the Employer response schema.

fields
filters
array of objects
required
Defaults to []

Filters to apply. An empty list returns every employer the caller has
permission to view.

filters*
integer | null
1 to 200
Defaults to 50

Maximum number of items per page (allowed range 1–200). Defaults to 50.

string | null

Opaque cursor from a previous response's response_metadata.next_cursor.
Omit on the first request.

Responses

Updated about 6 hours ago

Did this page help you?
Language
Credentials
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 6 hours ago

Did this page help you?