TSG GLOBAL/Developers
Campaign Manager Sandbox

List brands & campaigns

Discover the records already stored in Campaign Manager and use their opaque refs in subsequent requests.

Sandbox environment

Brand and campaign submissions are simulated. Nothing reaches The Campaign Registry and no carrier charges are incurred. Use credentials issued for this environment.

Find existing brands and campaigns

Use GET /brands and GET /campaigns to discover your company's records and their ref values. Your existing partner key supplies the company scope. Company partner/admin keys must omit X-Company-Ref; staff keys require an authorized company selection and the corresponding brands:read or campaigns:read permission.

Shell
curl --get "https://dev.10dlc-campaigns.com/api/v1/brands" \
  -H "Authorization: Bearer $TSG_API_KEY" \
  --data-urlencode "limit=25"

curl --get "https://dev.10dlc-campaigns.com/api/v1/campaigns" \
  -H "Authorization: Bearer $TSG_API_KEY" \
  --data-urlencode "limit=25"

Read every page

The response contains data.brands or data.campaigns, plus data.next_cursor. Each item includes its ref, status and identifying summary fields. Campaign summaries include campaign_name, brand_ref and the TCR/TNID campaign IDs. Use GET /brands/{ref} or GET /campaigns/{ref} for the full record.

  1. Omit cursor on the first request. limit defaults to 25 and must be an integer from 1 through 100.
  2. If data.next_cursor is not null, send it unchanged as the next request's cursor query parameter. With curl, use --data-urlencode "cursor=$NEXT_CURSOR".
  3. Stop when data.next_cursor is null. Empty lists return an empty array and a null cursor.

Filter campaigns by brand

To list campaigns for one brand, add brand_ref=<brand-ref> to GET /campaigns and keep that filter on subsequent pages. Cursors cannot be reused for another company, list or filter. Invalid cursors return 400 invalid_cursor; invalid limits return 422 invalid_limit. Unknown or repeated query parameters are rejected.

Understand list behavior

Lists include all statuses and sort by opaque reference, not creation date. They are a live view; restart a traversal to include records inserted before an earlier cursor. They read records already stored in Campaign Manager. TCR campaigns appear after a separate authorized import.