---
title: "GET a Collection of Email Campaigns"
method: GET
path: "/emails"
tags: ["Email Campaigns"]
---

# GET a Collection of Email Campaigns

`GET /emails`

Use this method to list and get details about your email campaigns. By default, this method returns all email campaigns for the user account including deleted email campaigns. To get email campaigns within a date-range, use the `after_date` and `before_date` query parameters.

This endpoint does not return campaign activity details for each email campaign in the collection. To get email campaign activity details for a single email campaign, use the GET `/emails/{campaign_id}` endpoint."
<div class="Msg"><p class="note-text">This method does not currently support filtering results using the email campaign creation date.</p></div>

## Query parameters

- `limit` integer
- `before_date` string, date-time
- `after_date` string, date-time

## Response `200`

Request successful.

- PagedEmailCampaignResponse
  - `_links` EmailsPagingLinks
    - `next` EmailsLink
      - `href` string
  - `campaigns` EmailCampaigns[]
    - `campaign_id` string — The unique ID used to identify the email campaign (UUID format).
    - `created_at` string, date-time — The system generated date and time that this email campaign was created. This string is readonly and is in ISO-8601 format.
    - `current_status` string — The current status of the email campaign. Valid values are: <ul> <li>Draft — An email campaign that you have created but have not sent to contacts.</li> <li>Scheduled — An email campaign that you have scheduled for Constant Contact to send to contacts.</li> <li>Executing — An email campaign that Constant Contact is currently sending to contacts. Email campaign activities are only in this status briefly.</li> <li>Done — An email campaign that you successfully sent to contacts.</li> <li>Error — An email campaign activity that encountered an error.</li> <li>Removed — An email campaign that a user deleted. Users can view and restore deleted emails through the UI.</li> </ul>
    - `name` string — The descriptive name the user provides to identify this campaign. Campaign names must be unique for each account ID.
    - `type` string — Identifies the type of campaign that you select when creating the campaign. Newsletter and Custom Code email campaigns are the primary types.
    - `type_code` integer — The code used to identify the email campaign `type`. <ul> <li> 1 (Default) </li> <li> 2 (Bulk Email) </li> <li> 10 (Newsletter) </li> <li> 11 (Announcement) </li> <li> 12 (Product/Service News) </li> <li> 14 (Business Letter) </li> <li> 15 (Card) </li> <li> 16 (Press release)</li> <li> 17 (Flyer) </li> <li> 18 (Feedback Request) </li> <li> 19 (Ratings and Reviews) </li> <li> 20 (Event Announcement) </li> <li> 21 (Simple Coupon) </li> <li> 22 (Sale Promotion) </li> <li> 23 (Product Promotion) </li> <li> 24 (Membership Drive) </li> <li> 25 (Fundraiser) </li> <li> 26 (Custom Code Email)</li> <li> 57 (A/B Test)</li> </ul>
    - `updated_at` string, date-time — The system generated date and time showing when the campaign was last updated. This string is read only and is in ISO-8601 format.

## Other responses

- `400` — Bad request. Either the JSON was malformed or there was a data validation error.
- `401` — The Access Token used is invalid.
- `403` — Forbidden request. You lack the necessary scopes, you lack the necessary user privileges, or the application is deactivated.
- `404` — The requested resource was not found.
- `429` — Too many requests. You exceeded the request rate limit.
- `500` — There was a problem with our internal service.

---

[API](https://skmtc.net/cc/apis/appconnect-v3.md) · [All operations](https://skmtc.net/cc/apis/appconnect-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cc/appconnect-v3/versions/4b4a534c818d/schema)