Skip to main content
GET
/
campaigns
curl --request GET \
  --url 'https://api.autosend.com/v1/campaigns?status=draft&page=1&limit=20' \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": {
    "campaigns": [
      {
        "id": "60d5ec49f1b2c72d9c8b4567",
        "name": "Spring Sale Newsletter",
        "subject": "Don't miss our Spring Sale!",
        "previewText": "Up to 50% off this weekend only",
        "status": "draft",
        "sendMode": "immediate",
        "trackingClick": true,
        "trackingOpen": true,
        "createdAt": "2026-03-01T10:00:00.000Z",
        "updatedAt": "2026-03-15T14:30:00.000Z"
      },
      {
        "id": "60d5ec49f1b2c72d9c8b4568",
        "name": "Welcome Series - Week 1",
        "subject": "Welcome to Autosend!",
        "previewText": "Get started in minutes",
        "status": "sent",
        "sendMode": "scheduled",
        "trackingClick": true,
        "trackingOpen": true,
        "metrics": {
          "sent": 200,
          "delivered": 200,
          "opened": 160,
          "suppressed": 0,
          "clicked": 0,
          "bounced": 0,
          "unsubscribed": 0,
          "spamReported": 0,
          "processedCount": 200,
          "totalContacts": 200,
          "failedCount": 0
        },
        "sentAt": "2026-04-06T05:54:51.190Z",
        "createdAt": "2026-02-15T08:00:00.000Z",
        "updatedAt": "2026-02-20T09:45:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 2,
      "totalPages": 1
    }
  }
}

curl --request GET \
  --url 'https://api.autosend.com/v1/campaigns?status=draft&page=1&limit=20' \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": {
    "campaigns": [
      {
        "id": "60d5ec49f1b2c72d9c8b4567",
        "name": "Spring Sale Newsletter",
        "subject": "Don't miss our Spring Sale!",
        "previewText": "Up to 50% off this weekend only",
        "status": "draft",
        "sendMode": "immediate",
        "trackingClick": true,
        "trackingOpen": true,
        "createdAt": "2026-03-01T10:00:00.000Z",
        "updatedAt": "2026-03-15T14:30:00.000Z"
      },
      {
        "id": "60d5ec49f1b2c72d9c8b4568",
        "name": "Welcome Series - Week 1",
        "subject": "Welcome to Autosend!",
        "previewText": "Get started in minutes",
        "status": "sent",
        "sendMode": "scheduled",
        "trackingClick": true,
        "trackingOpen": true,
        "metrics": {
          "sent": 200,
          "delivered": 200,
          "opened": 160,
          "suppressed": 0,
          "clicked": 0,
          "bounced": 0,
          "unsubscribed": 0,
          "spamReported": 0,
          "processedCount": 200,
          "totalContacts": 200,
          "failedCount": 0
        },
        "sentAt": "2026-04-06T05:54:51.190Z",
        "createdAt": "2026-02-15T08:00:00.000Z",
        "updatedAt": "2026-02-20T09:45:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 2,
      "totalPages": 1
    }
  }
}

​
Authorizations

​
Authorizations
string | header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

​
Query Parameters

​
status
string
Filter campaigns by status. One of: draft, scheduled, sending, sending_gradual, paused, sent, failed, aborted.
​
name
string
Filter campaigns by name. Supports partial matching.
​
page
integer
Page number for pagination. Must be at least 1. Defaults to 1.
​
limit
integer
Number of results to return per page. Must be between 1 and 100. Defaults to 20.
​
startDate
string
ISO 8601 date-time string. Only campaigns created on or after this date are returned.
​
endDate
string
ISO 8601 date-time string. Only campaigns created on or before this date are returned.
​
includeCounts
string
Whether to include recipient and send counts in each campaign object. Pass "true" or "false".

​
Response

Returns a paginated list of campaign objects.
​
success
boolean
Indicates whether the request was successful.
​
data
object
Response payload.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer , where is your auth token.

Query Parameters

​
status
enum<string>

Filter by campaign status.

Available options:
draft,
scheduled,
sending,
sending_gradual,
paused,
sent,
failed,
aborted
​
name
string

Filter by campaign name (partial match).

​
page
integer

Page number for pagination.

Required range: x >= 1
​
limit
integer

Number of results per page (1–100).

Required range: 1 <= x <= 100
​
startDate
string<date-time>

Filter campaigns created on or after this ISO 8601 date.

​
endDate
string<date-time>

Filter campaigns created on or before this ISO 8601 date.

​
includeCounts
enum<string>

Include recipient/send counts in the response.

Available options:
true,
false

Response

List of campaigns returned successfully.

​
success
boolean
Example:

true

​
data
object