---
title: "List email campaigns with optional status filter and pagination"
method: GET
path: "/v2/email/campaigns"
tags: ["email-campaigns-v2"]
---

# List email campaigns with optional status filter and pagination

`GET /v2/email/campaigns`

## Request

- Base URL: `https://api.tracklysms.com/api`
- URL: `https://api.tracklysms.com/api/v2/email/campaigns`
- Auth: API key in header `X-Api-Key`

## Query parameters

- `per_page` string
- `page` string
- `status` string

## Response `200`

Success

- EmailCampaignsListResponse
  - `campaigns` EmailCampaignResponse[]
    - `abTest` object: A/B test config
    - `complianceStatus` string: Compliance check status
    - `createdAt` string, date-time: Creation timestamp
    - `fromEmail` string: Sender email
    - `fromName` string: Sender name
    - `id` string: Campaign ID
    - `listIds` string[]: Target list IDs
    - `name` string: Campaign name
    - `replyTo` string: Reply-To address
    - `scheduledAt` string, date-time: Scheduled send time
    - `segmentIds` string[]: Target segment IDs
    - `sendType` string: Send type
    - `stats` object: Campaign statistics
    - `status` string: Campaign status
    - `subject` string: Subject line
    - `templateId` string: Template ID
    - `updatedAt` string, date-time: Last update timestamp
  - `pagination` object: Pagination info

## Other responses

- `401`: Authentication error

---

[API](https://skmtc.dev/tracklysms/apis/trackly-sms-api.md) · [All operations](https://skmtc.dev/tracklysms/apis/trackly-sms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tracklysms/apis/trackly-sms-api/revisions/ac1ad22cb2a9?raw)