---
title: "Directory"
method: GET
path: "/employer/directory"
tags: ["Organization"]
---

# Directory

`GET /employer/directory`

Read company directory and organization structure

## Query parameters

- `entity_ids` string[]
- `limit` integer
- `offset` integer

## Headers

- `Finch-API-Version` string, date, required

## Response `200`

Company directory and organization structure

- GetDirectoryResponse
  - `paging` Paging, required
    - `count` integer — The total number of elements for the entire query (not just the given page)
    - `offset` integer, required — The current start index of the returned list of elements
  - `individuals` object[], required — The array of employees.
    - `id` string, uuid, required — A stable Finch `id` (UUID v4) for an individual in the company.
    - `first_name` string, nullable, required — The legal first name of the individual.
    - `middle_name` string, nullable, required — The legal middle name of the individual.
    - `last_name` string, nullable, required — The legal last name of the individual.
    - `manager` object, nullable, required — The manager object.
      - `id` string, uuid, required — A stable Finch `id` (UUID v4) for an individual in the company.
    - `department` object, nullable, required — The department object.
      - `name` string, nullable — The name of the department.
    - `is_active` boolean, nullable, required — `true` if the individual is an active employee or contractor at the company.

## Other responses

- `202` — The request has been accepted for processing, but data is not yet available
- `422` — The request could not be processed due to a validation error

---

[API](https://skmtc.net/finch-api/apis/api-reference.md) · [All operations](https://skmtc.net/finch-api/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/finch-api/api-reference/revisions/f1cca2cb0ef2/schema)