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.
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.
- Omit
cursoron the first request.limitdefaults to 25 and must be an integer from 1 through 100. - If
data.next_cursoris not null, send it unchanged as the next request'scursorquery parameter. With curl, use--data-urlencode "cursor=$NEXT_CURSOR". - Stop when
data.next_cursoris 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.