List campaigns
GET {{baseUrl}}/ad_accounts/:ad_account_id/campaigns?campaign_ids=84772&entity_statuses=ACTIVE&entity_statuses=ACTIVE&page_size=25&order=ASCENDING&bookmark=aliqua adipisicing ad ullamco officia
Get a list of the campaigns in the specified adaccountid
, filtered by the specified options.
- The token's user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via Business Access: Admin, Analyst, Campaign Manager.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
campaign_ids | number | List of Campaign Ids to use to filter the results. | |
entity_statuses | string | Entity status | |
entity_statuses | string | Entity status | |
page_size | number | Maximum number of items to include in a single page of the response. See documentation on <a href='/docs/api/v5/#tag/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":"549755885175","id":"549755885175","name":"ACME Tools","status":"ACTIVE","lifetime_spend_cap":1432744744,"daily_spend_cap":1432744744,"order_line_id":"549755885175","tracking_urls":{"impression":["URL1","URL2"],"click":["URL1","URL2"],"engagement":["URL1","URL2"],"buyable_button":["URL1","URL2"],"audience_verification":["URL1","URL2"]},"start_time":1580865126,"end_time":1644023526,"objective_type":"AWARENESS","created_time":1432744744,"updated_time":1432744744,"type":"campaign"},{"ad_account_id":"549755885175","id":"549755885175","name":"ACME Tools","status":"ACTIVE","lifetime_spend_cap":1432744744,"daily_spend_cap":1432744744,"order_line_id":"549755885175","tracking_urls":{"impression":["URL1","URL2"],"click":["URL1","URL2"],"engagement":["URL1","URL2"],"buyable_button":["URL1","URL2"],"audience_verification":["URL1","URL2"]},"start_time":1580865126,"end_time":1644023526,"objective_type":"ENGAGEMENT","created_time":1432744744,"updated_time":1432744744,"type":"campaign"}],"bookmark":"laboris irure a"}