---
title: "List tracking links"
method: GET
path: "/v3/tracking_links"
tags: ["Tracking Links"]
---

# List tracking links

`GET /v3/tracking_links`

Tracking links are unique short URLs (e.g. `https://grnh.se/<token>`) that an organization shares to attribute candidates to a `source` — campaign URLs, referral links, employee outreach, social posts, and third-party board placements. When a candidate applies through a tracking link, the application inherits the link's `source_id` and any related attribution (referrer, related post). Each link belongs to exactly one organization and is scoped to a job, job board, or job post.

## 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[]
- `source_ids` integer[]
- `referrer_ids` integer[]
- `job_board_ids` integer[]
- `job_post_ids` integer[]
- `related_post_ids` integer[]
- `fields` string[]
- `token` string
- `related_post_type` string

## Response `200`

Successful

- object[]
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `job_id` integer, nullable — Id of the job this tracking link is scoped to. `null` when the link targets a job board or a job post rather than a specific job.
  - `token` string — Unique short-URL token appended to the link as `gh_src=<token>`. Resolves to the full URL `https://grnh.se/<token>` and is the value Greenhouse uses to attribute incoming applications back to this link.
  - `source_id` integer, nullable — Id of the `source` credited when a candidate applies through this link. Applications submitted via the link inherit this `source_id`. `null` for links created before a source was selected.
  - `related_post_id` integer, nullable — Id of the polymorphic record the link is associated with (e.g. a programmatic job ad, a social media post). Use together with `related_post_type` to resolve the referenced record. `null` for links not tied to a related post.
  - `related_post_type` string, nullable — Class name of the polymorphic `related_post` record (e.g. `Application`, `ProgrammaticSourcing::AppcastJobAd`). `null` for links not tied to a related post.
  - `referrer_id` integer, nullable — Id of the referring user credited with surfacing the candidate. Populated for employee-referral links so the referring user is attributed when the candidate applies. `null` when the link is not a referral link.
  - `job_board_id` integer, nullable — Id of the `job_board` this link targets. Set when the link points at an entire board rather than a specific job or post. `null` when the link is scoped to a job or job post.
  - `job_post_id` integer, nullable — Id of the `job_post` this link targets. Set when the link points at a specific public-facing post. `null` when the link is scoped to a job or job board.

---

[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)