Get customer lists

GET {{baseUrl}}/ad_accounts/:ad_account_id/customer_lists?page_size=25&order=ASCENDING&bookmark=ut aliqua enim magna

Get a set of customer lists including id and name based on the filters provided.

(Customer lists are a type of audience.) For more information, see Audience targeting or the Audiences section of the ads management guide.

Request Params

KeyDatatypeRequiredDescription
page_sizenumberMaximum number of items to include in a single page of the response. See documentation on <a href='/docs/getting-started/pagination/'>Pagination</a> for more information.
orderstringThe order in which to sort the items returned: “ASCENDING” or “DESCENDING”
by ID. Note that higher-value IDs are associated with more-recently added
items.
bookmarkstringCursor used to fetch the next page of items

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;items&quot;:[{&quot;ad_account_id&quot;:&quot;549756359984&quot;,&quot;created_time&quot;:1452208622,&quot;id&quot;:&quot;643&quot;,&quot;name&quot;:&quot;The Glengarry Glen Ross leads&quot;,&quot;num_batches&quot;:2,&quot;num_removed_user_records&quot;:0,&quot;num_uploaded_user_records&quot;:11,&quot;status&quot;:&quot;PROCESSING&quot;,&quot;type&quot;:&quot;customerlist&quot;,&quot;updated_time&quot;:1461269616,&quot;exceptions&quot;:{}},{&quot;ad_account_id&quot;:&quot;549756359984&quot;,&quot;created_time&quot;:1452208622,&quot;id&quot;:&quot;643&quot;,&quot;name&quot;:&quot;The Glengarry Glen Ross leads&quot;,&quot;num_batches&quot;:2,&quot;num_removed_user_records&quot;:0,&quot;num_uploaded_user_records&quot;:11,&quot;status&quot;:&quot;PROCESSING&quot;,&quot;type&quot;:&quot;customerlist&quot;,&quot;updated_time&quot;:1461269616,&quot;exceptions&quot;:{}}],&quot;bookmark&quot;:&quot;occaecat eiusmod voluptate et consequat&quot;}