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

# Directory

`GET /employer/directory`

Read company directory and organization structure

## Query parameters

- `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 — The current start index of the returned list of elements
  - `individuals` object[], required — The array of employees.
    - `id` string, uuid — A stable Finch `id` (UUID v4) for an individual in the company.
    - `first_name` string, nullable — The legal first name of the individual.
    - `middle_name` string, nullable — The legal middle name of the individual.
    - `last_name` string, nullable — The legal last name of the individual.
    - `manager` object, nullable — The manager object.
      - `id` string, uuid — A stable Finch `id` (UUID v4) for an individual in the company.
    - `department` object, nullable — The department object.
      - `name` string, nullable — The name of the department.
    - `is_active` boolean, nullable — `true` if the individual is an active employee or contractor at the company.

---

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