List Campaigns
Lists every campaign in the store — the data behind the admin Marketing → Communications → Campaigns datagrid.
TIP
New here? Read the Campaigns overview for what a campaign does and how its fields behave.
Endpoint
| Endpoint | Method |
|---|---|
/api/admin/marketing/campaigns | GET |
Response envelope
Admin collections return a { data, meta } body envelope:
data— the campaign rows for this page.meta—currentPage,perPage,lastPage,total,from,to.
Each row carries the campaign's scalar fields shown in the example. The channel, customerGroup, marketingTemplate, and marketingEvent objects are served only by the detail endpoint; they are null on list rows.
Query parameters
| Parameter | Description |
|---|---|
page, per_page | Pagination (per_page default 10, max 50) |
name | Name — partial match |
status | 0 (inactive) / 1 (active) |
marketing_template_id | Linked email-template id |
marketing_event_id | Linked event id |
channel_id | Channel id |
customer_group_id | Customer-group id |
sort, order | Sort field (id, name) + asc / desc (default id desc) |
Filters compose with logical AND — more filters narrow the result.
Every /api/admin/* request requires an admin Bearer token.