Get customer lists
GET {{baseUrl}}/ad_accounts/:ad_account_id/customer_lists?page_size=25&order=DESCENDING&bookmark=<string>
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
| Key | Datatype | Required | Description |
|---|---|---|---|
page_size | number | Maximum 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. | |
order | string | The 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. | |||
bookmark | string | Cursor used to fetch the next page of items |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"items":[{"ad_account_id":"\u003cstring\u003e","created_time":"\u003cnumber\u003e","id":"\u003cstring\u003e","name":"\u003cstring\u003e","num_batches":"\u003cnumber\u003e","num_removed_user_records":"\u003cnumber\u003e","num_uploaded_user_records":"\u003cnumber\u003e","status":"TOO_SMALL","type":"\u003cstring\u003e","updated_time":"\u003cnumber\u003e","exceptions":{}},{"ad_account_id":"\u003cstring\u003e","created_time":"\u003cnumber\u003e","id":"\u003cstring\u003e","name":"\u003cstring\u003e","num_batches":"\u003cnumber\u003e","num_removed_user_records":"\u003cnumber\u003e","num_uploaded_user_records":"\u003cnumber\u003e","status":"UPLOADING","type":"\u003cstring\u003e","updated_time":"\u003cnumber\u003e","exceptions":{}}],"bookmark":"\u003cstring\u003e"}