Skip to main content

Agency - List Client Audiences

API to retrieve a list of audiences in a agency or white label client account

Updated over a week ago

Please see this article for information on API authorization, testing endpoints, and how obtain your API key.

If you would like to programmatically retrieve a list of audiences in a specific client accountId in your agency or white label account, you can leverage this API endpoint to achieve this.

The call to this endpoint must be an HTTP GET to: https://api.leadpost.com/api/v1.0/agency/clients/{accountId}/audiences
​

If you need to retrieve a list of client accounts via API to determine a client's accountId, please see our Agency - List Clients API.

The response will a select list of non-null audience properties for the client campaign, as shown below:

[
{
"audienceId": 28345,
"name": "My Email Suppression list",
"audienceTypeId": 5,
"audienceType": "Email Data"
},
{
"audienceId": 28198,
"name": "My Customer List",
"audienceTypeId": 6,
"audienceType": "CRM Data"
},
{
"audienceId": 25000,
"name": "Default Pixel",
"audienceTypeId": 8,
"audienceType": "Site Visitor Data",
"pixelCode": "<img src='https://rdcdn.com/rt?aid=25000&e=1&img=1' height='1' width='1' referrerpolicy='no-referrer-when-downgrade' />",
"javaScriptCode": "<script type='text/javascript'>\r\n (function (w, d, s, u, dbg) {\r\n var js, fjs = d.getElementsByTagName(s)[0];\r\n window.rdcndbg = dbg;\r\n js = d.createElement(s);\r\n js.async = true;\r\n js.src = u;\r\n fjs.parentNode.insertBefore(js, fjs);\r\n })(window, document, 'script', 'https://rdcdn.com/rtjs?aid=25000', false);\r\n</script>",
"audiencePixelFireInfo": {
"LastPixelFirePageViewUrl": "http://domain.com/collections",
"LastPixelFireTagUrl": "http://rdcdn.com/rt?aid=25000",
"LastPixelFireObservedOn": "2025-07-24T13:26:40.102-05:00"
}
}
]

Note that pixel audiences will include both the Pixel Code and JavaScript code for an audience, and an object named audiencePixelFireInfo with properties indicating details on the most recent pixel fire, assuming at least one pixel fire has been observed. This data would be especially useful you would like to programmatically monitor client pixels to ensure they are online.

Did this answer your question?