> ## Documentation Index
> Fetch the complete documentation index at: https://docs.autosend.com/llms.txt
> Use this file to discover all available pages before exploring further.
# List Campaigns
> List all campaigns in your account with optional filtering and pagination using the AutoSend API.
```bash cURL theme={null}
curl --request GET \
--url 'https://api.autosend.com/v1/campaigns?status=draft&page=1&limit=20' \
--header 'Authorization: Bearer '
```
```python Python theme={null}
import requests
url = "https://api.autosend.com/v1/campaigns"
params = {
"status": "draft",
"page": 1,
"limit": 20
}
headers = {"Authorization": "Bearer "}
response = requests.get(url, params=params, headers=headers)
print(response.json())
```
```javascript JavaScript theme={null}
const response = await fetch(
'https://api.autosend.com/v1/campaigns?status=draft&page=1&limit=20',
{
method: 'GET',
headers: {
Authorization: 'Bearer ',
},
}
);
const data = await response.json();
console.log(data);
```
```php PHP theme={null}
'https://api.autosend.com/v1/campaigns?status=draft&page=1&limit=20',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ',
],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
```
```go Go theme={null}
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.autosend.com/v1/campaigns?status=draft&page=1&limit=20", nil)
req.Header.Set("Authorization", "Bearer ")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
```
```java Java theme={null}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.autosend.com/v1/campaigns?status=draft&page=1&limit=20"))
.header("Authorization", "Bearer ")
.GET()
.build();
HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
```
```ruby Ruby theme={null}
require 'net/http'
require 'uri'
require 'json'
uri = URI('https://api.autosend.com/v1/campaigns')
uri.query = URI.encode_www_form(status: 'draft', page: 1, limit: 20)
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer '
response = http.request(request)
puts JSON.parse(response.body)
```
```json Response theme={null}
{
"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,
"pages": 1
}
}
}
```
### Authorizations
Bearer authentication header of the form Bearer ``, where `` is your auth token.
### Query Parameters
Filter campaigns by status. One of: `draft`, `scheduled`, `sending`, `sending_gradual`, `paused`, `sent`, `failed`, `aborted`.
Filter campaigns by name. Supports partial matching.
Page number for pagination. Must be at least `1`. Defaults to `1`.
Number of results to return per page. Must be between `1` and `100`. Defaults to `20`.
ISO 8601 date-time string. Only campaigns created on or after this date are returned.
ISO 8601 date-time string. Only campaigns created on or before this date are returned.
Whether to include recipient and send counts in each campaign object. Pass `"true"` or `"false"`.
### Response
Returns a paginated list of campaign objects.
Indicates whether the request was successful.
Response payload.
Array of campaign objects.
Unique identifier of the campaign.
Display name of the campaign.
Email subject line.
Preview text shown in email clients.
Current status of the campaign.
How the campaign is delivered: `immediate`, `scheduled`, or `gradual`.
Whether click tracking is enabled.
Whether open tracking is enabled.
Send and engagement metrics. Only present on campaigns that have been sent.
Total emails sent.
Total emails delivered.
Total emails opened.
Total link clicks.
Total bounced emails.
Total unsubscribes.
Total suppressed emails.
Total spam complaints.
Total emails processed.
Total contacts targeted.
Total failed sends.
ISO 8601 timestamp when the campaign was sent. Only present on sent campaigns.
ISO 8601 timestamp when the campaign was created.
ISO 8601 timestamp when the campaign was last updated.
Pagination metadata.
Current page number.
Number of results per page.
Total number of matching campaigns.
Total number of pages.
## OpenAPI
````yaml GET /campaigns
openapi: 3.1.0
info:
title: Autosend Campaigns API
version: 1.0.0
description: API endpoints for managing marketing campaigns in Autosend.
servers:
- url: https://api.autosend.com/v1
description: Production
security:
- bearerAuth: []
paths:
/campaigns:
get:
summary: List Campaigns
description: Retrieves a paginated list of campaigns with optional filtering.
components: {}
````