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

# List campaigns

`GET /campaigns`

## Request

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

Return a list of campaigns from your tenant. You may restrict the list of 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 campaigns

- CampaignListEnvelope: Paginated list of Campaigns
  - `data` Campaign[], required: Campaign items on this page
    - `deliver_at` string, date-time: The instant this campaign should be delivered
    - `id` string, required: Campaign id
    - `name` string, required: Campaign 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.md) - [All operations](https://skmtc.dev/amperity/apis/amperity-api/llms.txt) - [OpenAPI document](https://skmtc.dev/amperity/apis/amperity-api/revisions/97ccd051d9dc?raw)