---
title: "List hiring plans"
method: GET
path: "/{domain}/v1/plans"
tags: ["Discovery"]
---

# List hiring plans

`GET /{domain}/v1/plans`

Returns all hiring plans for the org. Use the returned id to filter GET /v1/headcount by plan.

## Path parameters

- `domain` string, required

## Response `200`

List of hiring plans.

- object[] — List of hiring plans for the org.
  - `id` string, uuid, required — UUID
  - `name` string, required — Display name
  - `is-active` boolean, required — Whether this is the currently active plan
  - `start-date` string, date-time, nullable — Plan start date
  - `end-date` string, date-time, nullable — Plan end date

## Other responses

- `401` — Request does not contain valid credentials.

---

[API](https://skmtc.net/teamohana/apis/teamohana-public-api.md) · [All operations](https://skmtc.net/teamohana/apis/teamohana-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/teamohana/teamohana-public-api/versions/55e225ee4219/schema)