---
title: "List Hiring Goals"
method: GET
path: "/v2/hiring_goals"
tags: ["Hiring Goals"]
---

# List Hiring Goals

`GET /v2/hiring_goals`

List all Hiring Goals within your account. Check the example to see all properties available.

## Query parameters

- `opening_id` integer
- `hiring_goal_id` string
- `page` integer
- `per_page` integer
- `sort_by` string
- `sort_direction` 'asc' | 'desc'
- `status` 'unfilled' | 'filled'
- `current` boolean
- `past` boolean
- `open` boolean
- `created_at_gt` string
- `created_at_lt` string
- `updated_at_gt` string
- `updated_at_lt` string
- `hire_by_gt` string
- `hire_by_lt` string

## Response `200`

OK

- object
  - `hiring_goals` HiringGoal[]
    - `automatically_close_on_date` string, nullable — Date that the Hiring Goal will automatically close
    - `closed_at` string, datetime — The date and time at which the hiring goal was closed
    - `created_at` string, datetime — The date and time at which the hiring goal was created
    - `external_id` string — Unique identifier of the Hiring Goal
    - `funnel_id` string — Unique identifier of the associated opening
    - `goal` integer — Number of hires needed for this Hiring Goal
    - `hire_by` string — Date that the Hiring Goal ends
    - `hires_count` integer — Number of hires currently associated with the Hiring Goal
    - `last_updated_at` string, datetime — The date and time at which the hiring goal was last updated
    - `past_due` boolean — Indicates if the hire_by date is in the past
    - `remaining_days` integer — Number of days until this Hiring Goal ends
    - `stage_id` string — Unique identifier of the associated stage
    - `start_date` string — Date that the Hiring Goal begins
    - `status` 'unfilled' | 'filled' — Current status of the Hiring Goal
    - `customer_attributes` CustomerAttribute[], nullable — List of customer attributes for the Hiring Goal
      - `value` string, required — Value of the attribute
      - `type` string, required — Human-readable display name of the attribute
      - `key` string, nullable — Machine-readable identifier for the attribute (e.g. JOB_CODE). Optional — not all endpoints that embed customer_attributes populate this field yet (e.g. openings, locations, and location groups currently return only type and value).
  - `pagination` Pagination
    - `first` integer — The first available page
    - `last` integer — The last available page
    - `previous` integer, nullable — The previous page
    - `current` integer — The current page
    - `next` integer, nullable — The next available page

## Other responses

- `401` — Unauthorized
- `501` — NotImplemented

---

[API](https://skmtc.net/fountain/apis/hire-public-api.md) · [All operations](https://skmtc.net/fountain/apis/hire-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fountain/hire-public-api/revisions/5f406c0e9462/schema)