---
title: "return lists of mailings. 🔓"
method: GET
path: "/v3/mailings"
tags: ["mailings"]
---

# return lists of mailings. 🔓

`GET /v3/mailings`

returns lists of mailings according to following filter settings<br/> <br/> <strong>NOTE:</strong> The <code>start</code> and <code>end</code> fields depend on the <code>state</code> field.<br/> &nbsp;&nbsp;-&nbsp;finished mails are filtered by finished time<br/> &nbsp;&nbsp;-&nbsp;draft mails are filtered by creation time<br/> &nbsp;&nbsp;-&nbsp;waiting mails are filtered by the time they will be sent<br/> &nbsp;&nbsp;-&nbsp;running mails are filtered by the time they have been started<br/>

## Query parameters

- `limit` integer
- `state` 'all' | 'finished' | 'draft' | 'waiting' | 'running' | 'automation'
- `channel_id` string
- `start` integer
- `end` integer
- `page` integer

## Response `200`

List of mailings

- string[]

---

[API](https://skmtc.net/cleverreach/apis/cleverreach-rest-api.md) · [All operations](https://skmtc.net/cleverreach/apis/cleverreach-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cleverreach/cleverreach-rest-api/revisions/b05c9b904be4/schema)