---
title: "List job notes"
method: GET
path: "/v3/job_notes"
tags: ["Job Notes"]
---

# List job notes

`GET /v3/job_notes`

## Request

- Base URL: `https://harvest.greenhouse.io`
- URL: `https://harvest.greenhouse.io/v3/job_notes`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://auth.greenhouse.io/authorize`
    - Client credentials
    - Token URL: `https://auth.greenhouse.io/token` scopes: `harvest:job_notes:list`
  - HTTP bearer

Job notes are free-form, organization-internal notes attached to a job (the requisition). They capture hiring-team context about the role itself and are distinct from candidate notes, which are attached to a candidate or application. Each note has a `visibility` that controls whether it is readable by Job Admins on the job or further restricted to users with the "view and create private job notes" permission.

## Query parameters

- `cursor` string
- `per_page` integer
- `ids` integer[]
- `created_at` object
  - `gte` string, date-time
  - `lte` string, date-time
  - `gt` string, date-time
  - `lt` string, date-time
- `updated_at` object
  - `gte` string, date-time
  - `lte` string, date-time
  - `gt` string, date-time
  - `lt` string, date-time
- `job_ids` integer[]
- `user_ids` integer[]
- `fields` string[]
- `visibility` 'admin_only_visible' | 'privately_visible'

## Response `200`

Successful

- object[]
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `job_id` integer: Id of the job this note is attached to. Job notes are always anchored to a single job and are not shared across jobs.
  - `user_id` integer: Id of the Greenhouse user who authored the note.
  - `body` string, nullable: Free-text body of the note. Newline characters are stored verbatim and rendered as line breaks in the Greenhouse UI.
  - `visibility` 'admin_only_visible' | 'privately_visible' | 'null', nullable: Who can see this note. `admin_only_visible` is restricted to users with Job Admin or higher access on the job; `privately_visible` is further restricted to users with the "view and create private job notes" permission on the job.

---

[API](https://skmtc.dev/greenhouse/apis/harvest-api.md) - [All operations](https://skmtc.dev/greenhouse/apis/harvest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/greenhouse/apis/harvest-api/revisions/822822e3f771?raw)