---
title: "Returns all traffic sources with their configuration."
method: GET
path: "/traffic-source"
tags: ["Tracker"]
---

# Returns all traffic sources with their configuration.

`GET /traffic-source`

Returns the list of traffic sources configured in the account, including their
custom variable name mappings, postback URLs, and cost tracking settings.

Filter and page **server-side** rather than fetching the whole collection and filtering locally.

Filters combine with AND, and each filter parameter's own description states whether it matches
exactly or as a case-insensitive substring. Filters are applied before paging, so a page contains
only entities matching the filters.

Send *limit* to page; without it this endpoint returns the whole matching collection - but the MCP
list_ tools default *limit* to 100, so through them a bare call is one page, not the complete
collection.

Paging is by cursor, not by position: a response that has more to give carries *nextId*, and you get
the following page by sending it back as the *nextId* parameter with the **same filters**. When
*nextId* is absent the collection is exhausted - there is no need for a further request to discover
that, and no total count to compare against. Do not construct a cursor yourself; ids are opaque here.

Freshness (*If-Modified-Since*) is judged over every entity of this type, not over the filtered page:
a change that moves an entity out of your filter, or onto a page you are not reading, still answers 200.
So the header combines with both filtering and paging, at the cost of the occasional 200 for a view that
did not itself change.

## Custom variable names

Each traffic source defines customVariable1Name through customVariable10Name,
which give meaning to the customVariable1-10 dimensions in reports.
The same index can mean completely different things on different traffic sources
(e.g. customVariable1 might be "Site ID" on one source and "Keyword" on another).

Read the variable name mappings from this endpoint before interpreting
groupBy=customVariable{N} report data. Cache the result — it rarely changes.

## Other fields relevant to report analysis

- postbackUrl — the URL used to fire conversions back to the traffic source
- costVariable — if present, the source passes cost data automatically

## Query parameters

- `note` string
- `nextId` string, uuid
- `name` string
- `limit` integer
- `includeDeleted` boolean
- `fields` string[]
- `workspaceId` string, uuid

## Headers

- `If-Modified-Since` string, date-time

## Response `200`

List of Traffic Sources.

---

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