List tracking links

get

https://harvest.greenhouse.io/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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

cursor

string

Cursor link for pagination from previous page response header. Do not use any other parameters when using this.

per_page

integer

1 to 500

Defaults to 100

Number of results per page

ids

array of integers

length ≤ 50

Comma separated list

ids

created_at

object

updated_at

object

job_ids

array of integers

length ≤ 50

Return only tracking links attached to these job (hiring plan) ids. A tracking link points at the careers page or a specific job post for these jobs.

job_ids

source_ids

array of integers

length ≤ 50

Comma separated list

source_ids

referrer_ids

array of integers

length ≤ 50

Return only tracking links attributed to these referrer ids. A referrer is the Greenhouse Referrer record (see GET /v3/referrers) — not a user id. Look up the referrer id for a user via that endpoint first.

referrer_ids

job_board_ids

array of integers

length ≤ 50

Comma separated list

job_board_ids

job_post_ids

array of integers

length ≤ 50

Comma separated list

job_post_ids

related_post_ids

array of integers

length ≤ 50

Return only tracking links generated for these related_post ids — the external post the link was distributed on (e.g. a tweet, LinkedIn post, or ProgrammaticSourcing::AppcastJobAd). Pair with related_post_type to disambiguate, since related_post is polymorphic.

related_post_ids

fields

array of strings

length ≤ 50

Comma separated list of fields to return

fields

token

string

Return the tracking link with this exact short-URL token (the gh_src value). Useful for resolving an incoming application's gh_src back to the link that generated it.

related_post_type

string

Filter by the polymorphic related_post class name (e.g. Application, ProgrammaticSourcing::AppcastJobAd). Combine with related_post_ids to narrow to a specific record of that type.

Response

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successful