v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-2148120293.6 KB
Organization

Directory

Read company directory and organization structure

get/employer/directory

Query parameters

entity_idsstring[]

The entity IDs to specify which entities' data to access. Provide exactly one entity ID per request; a maximum of one is accepted.

[
  "550e8400-e29b-41d4-a716-446655440000"
]
limitinteger

Number of employees to return (defaults to 100, maximum 10000)

offsetinteger

Index to start from (defaults to 0)

Headers

Finch-API-Versionstring date required

Header used to specify the version for a given API request. Current version is 2020-09-17.

Response

Company directory and organization structure