---
title: "List draft campaigns"
method: GET
path: "/campaign-drafts"
tags: ["Campaigns"]
---

# List draft campaigns

`GET /campaign-drafts`

## Request

- Base URL: `https://app.amperity.com/api`
- URL: `https://app.amperity.com/api/campaign-drafts`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/amperity/apis/amperity-api-2/docs/campaign-drafts/get.ts> (a function with typed inputs; its response is checked against the schema)

Return a list of draft campaigns from your tenant. You may restrict the list of draft campaigns to those associated with a specific data template.

## Query parameters

- `api_version` string
- `with_total` boolean
- `limit` integer
- `next_token` string
- `destination_data_template_id` string

## Headers

- `Amperity-Tenant` string, required
- `Api-Version` string, required

## Response `200`

List of draft campaigns

- CampaignListEnvelope: Paginated list of Campaigns
  - `data` CampaignDraft[], required: Campaign draft items on this page
    - `deliver_at` string, date-time: The instant this campaign should be delivered
    - `id` string, required: CampaignDraft id
    - `name` string, required: CampaignDraft name
  - `next_token` string: The cursor value to use in a subsequent request to return the next page of results.
  - `total` integer: The total count of all results. This property is only returned when `with_total` is set to `true` in a request.

## Other responses

- `400`: Bad Request
- `401`: Authentication Required
- `403`: Not Authorized
- `404`: Not Found
- `405`: Method Not Allowed
- `500`: Internal Error

---

[API](https://skmtc.dev/amperity/apis/amperity-api-2.md) - [All operations](https://skmtc.dev/amperity/apis/amperity-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/amperity/apis/amperity-api-2/revisions/4bc55ca3450d?raw)