---
title: "Get Your Campaigns"
method: GET
path: "/v1/campaigns"
tags: ["Campaigns"]
---

# Get Your Campaigns

`GET /v1/campaigns`

## Request

- Base URL: `https://api.dexatel.com`
- URL: `https://api.dexatel.com/v1/campaigns`
- Auth: API key in header `X-Dexatel-Key`

## Query parameters

- `page_size` string: Default value is 10, can be at maximum 1000
- `page_token` string: Found in pagination links and can be used to get 'previous' or 'next' items
- `filter[channel]` 'SMS' | 'VIBER' | 'WHATSAPP': Filter by Channel. Enumeration values [SMS, VIBER, WHATSAPP]
- `filter[statuses]` EnumCampaignStatuses[]

## Response `200`

OK

- CampaignResponseListWrapperDto
  - `data` CampaignResponseDto[]
    - `id` string, uuid: Unique identifier of the campaign
    - `sender` string: Name (unique identifier) of the sender
    - `account_id` string, uuid: Unique identifier of the account
    - `template_id` string, uuid: Unique identifier of the template
    - `audience_id` string, uuid: Unique identifier of the audience
    - `name` string: Unique name of the campaign
    - `status` 'in_progress' | 'completed' | 'scheduled' | 'canceled': Status of the campaign. Enumeration values [in_progress, completed, scheduled, canceled]
    - `channel` 'SMS' | 'VIBER' | 'WHATSAPP': Channel of the campaign. Enumeration values [SMS, VIBER, WHATSAPP]
    - `schedule` string, date-time: Schedule date of the campaign in UTC, formatted as yyyy-mm-dd hh:mm:ss
    - `create_date` string, date-time: Creation date of the campaign in UTC, formatted as yyyy-mm-dd hh:mm:ss
    - `update_date` string, date-time: Update date of the campaign in UTC, formatted as yyyy-mm-dd hh:mm:ss
  - `pagination` Pagination
    - `number` integer: Current page number
    - `size` integer: Page size. Default value is 10, can be at maximum 1000
    - `total` integer: Total count of requested resources
    - `links` object: Contains URLs to get next/previous resources
      - `first` string: URL to the first page
      - `current` string: URL to the current page
      - `previous` string: URL to the previous page, if any
      - `next` string: URL to the next page, if any

---

[API](https://skmtc.dev/dexatel/apis/contacts-and-messaging.md) - [All operations](https://skmtc.dev/dexatel/apis/contacts-and-messaging/llms.txt) - [OpenAPI document](https://skmtc.dev/dexatel/apis/contacts-and-messaging/revisions/f07e4f03a129?raw)