---
title: "sourceTrackingLink.list"
method: POST
path: "/sourceTrackingLink.list"
tags: ["Source Tracking Links"]
---

# sourceTrackingLink.list

`POST /sourceTrackingLink.list`

List all source custom tracking links

**Requires the [`hiringProcessMetadataRead`](authentication#permissions-sourcetrackinglinklist) permission.**

## Request body

- SourceTrackingLinkListRequest
  - `includeDisabled` boolean, nullable — When true, includes disabled tracking links. Defaults to false.
  - `sourceId` string, uuid, nullable — Restrict the response to tracking links associated with this source id.
  - `cursor` string, nullable — The pagination cursor. Use 'start' for the first page or the nextCursor value from a previous response.
  - `limit` integer, nullable — The maximum number of tracking links to return per page. Maximum is 100.
  - `syncToken` string, nullable — A sync token to retrieve only tracking links updated since the last sync. Obtained from a previous list response.

## Response `200`

Responses from the sourceTrackingLink.list endpoint

- union
  - SourceTrackingLinkListSuccessResponse
    - `success` true, required
    - `results` SourceTrackingLink[], required
      - `id` string, uuid, required — The tracking link's unique identifier
      - `code` string, required — The tracking code appended to the link as a UTM source
      - `enabled` boolean, required — Whether the tracking link is enabled
      - `sourceId` string, uuid, required — The id of the source this tracking link is associated with
      - `link` string, required — The fully-formed candidate-facing URL with the tracking code applied
    - `nextCursor` string — Cursor for the next page of results, if available
    - `moreDataAvailable` boolean — Whether more data is available beyond this page
    - `syncToken` string — Sync token to use for future incremental syncs. Only present on the last page.
  - ErrorResponse
    - `success` false, required
    - `errors` ErrorDetail[], required
      - `message` string, required
      - `parameter` string

---

[API](https://skmtc.net/ashbyhq/apis/ashby-api.md) · [All operations](https://skmtc.net/ashbyhq/apis/ashby-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ashbyhq/ashby-api/revisions/778b919dc743/schema)