---
title: "List referrers"
method: GET
path: "/v3/referrers"
tags: ["Referrers"]
---

# List referrers

`GET /v3/referrers`

Referrers are the people credited with bringing a candidate into the pipeline — typically employees making referrals, but also agency recruiters, LinkedIn recruiters, or any other party captured under "Who Gets Credit" on a candidate's application. Each row is one referrer in the organization; resolve a referrer for an application by joining `applications.referrer_id` to this resource's `id`. A referrer is distinct from a Greenhouse user and from a source: `user_id` may link a referrer to a user when one exists but is often `null`, and the `Referral` source on an application tells you the channel while the referrer tells you the specific person credited. Filter to a single user's referrer records with `user_ids`. This endpoint is read-only; referrers are created and edited through the Greenhouse UI, not the Harvest API.

## 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
- `user_ids` integer[]
- `fields` string[]

## Response `200`

Successful

- object[]
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `user_id` integer, nullable — Id of the Greenhouse user this referrer maps to, when the referrer is an internal employee. `null` for referrers that are not Greenhouse users (e.g. external agency recruiters, social-share visitors, LinkedIn referrers) and for referrers whose underlying user has since been removed. This is not the same id space as `applications.referrer_id` — applications point at this referrer's `id`, not at `user_id`.
  - `name` string — Display name of the referrer as it appears on the candidate's application under "Source & referrer" (the "Who Gets Credit" label). For employee referrals this is typically the referring user's name; for non-user referrers it is the name captured at referral time.

---

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