---
updatedAt: 2026-08-17T22:39:53.000Z
agentTools:
  projectIndex: https://developers.activecampaign.com/llms.txt
---

# List all contacts in an automation

List the contacts currently in, or that have run through, a single automation. This is a paginated equivalent of filtering `/api/3/contactAutomations` by `filters[seriesid]`.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "v3",
    "version": "3"
  },
  "servers": [
    {
      "url": "https://{youraccountname}.api-us1.com/api/3",
      "variables": {
        "youraccountname": {
          "default": "youraccountname"
        }
      }
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "name": "Api-Token",
        "in": "header",
        "x-default": ""
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/automations/{seriesId}/contactAutomations": {
      "get": {
        "summary": "List all contacts in an automation",
        "description": "List the contacts currently in, or that have run through, a single automation. This is a paginated equivalent of filtering `/api/3/contactAutomations` by `filters[seriesid]`.",
        "operationId": "list-all-contactautomations-for-automation",
        "parameters": [
          {
            "name": "seriesId",
            "in": "path",
            "description": "ID of the automation to receive contacts for",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "required": true
          },
          {
            "name": "filters[subscriberid]",
            "in": "query",
            "description": "Filter by contact ID. Supported operators: `eq`, `gt`, `gte`, `lt`, `lte`, `in`. Example: `filters[subscriberid][gt]=10`",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "filters[status]",
            "in": "query",
            "description": "Filter by run status: 1 = in progress, 2 = ended. Supported operators: `eq`, `gt`, `gte`, `lt`, `lte`, `in`. Example: `filters[status][gt]=1`",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "filters[lastblock]",
            "in": "query",
            "description": "Filter by the ID of the last automation block the contact reached. Supported operators: `eq`, `gt`, `gte`, `lt`, `lte`, `in`. Example: `filters[lastblock][gt]=5`",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "filters[adddate]",
            "in": "query",
            "description": "Filter by the date the contact entered the automation. Accepts `YYYY-MM-DD` (matches the whole day) or `YYYY-MM-DD HH:MM:SS`. Supported operators: `eq`, `gt`, `gte`, `lt`, `lte`, `in`. Example: `filters[adddate][gt]=2026-01-01`",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "orders[adddate]",
            "in": "query",
            "description": "Order by the date the contact entered the automation",
            "schema": {
              "type": "string",
              "enum": [
                "desc",
                "asc"
              ]
            }
          },
          {
            "name": "orders[status]",
            "in": "query",
            "description": "Order by run status",
            "schema": {
              "type": "string",
              "enum": [
                "desc",
                "asc"
              ]
            }
          },
          {
            "name": "orders[seriesid]",
            "in": "query",
            "description": "Order by automation ID",
            "schema": {
              "type": "string",
              "enum": [
                "desc",
                "asc"
              ]
            }
          },
          {
            "name": "orders[subscriberid]",
            "in": "query",
            "description": "Order by contact ID",
            "schema": {
              "type": "string",
              "enum": [
                "desc",
                "asc"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The number of records to return per request. Defaults to 20 and is capped at 100.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 20
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "Offset index of records to return.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"contactAutomations\": [\n        {\n            \"contact\": \"1\",\n            \"seriesid\": \"2\",\n            \"startid\": \"0\",\n            \"status\": \"1\",\n            \"batchid\": null,\n            \"adddate\": \"2026-01-14T09:12:44-06:00\",\n            \"remdate\": null,\n            \"timespan\": null,\n            \"lastblock\": \"5\",\n            \"lastlogid\": \"31\",\n            \"lastdate\": \"2026-01-14T09:12:44-06:00\",\n            \"in_als\": \"0\",\n            \"completedElements\": \"3\",\n            \"totalElements\": \"7\",\n            \"completed\": \"0\",\n            \"completeValue\": \"42\",\n            \"links\": {\n                \"automation\": \"https://:account.api-us1.com/api/3/contactAutomations/1/automation\",\n                \"contact\": \"https://:account.api-us1.com/api/3/contactAutomations/1/contact\",\n                \"contactGoals\": \"https://:account.api-us1.com/api/3/contactAutomations/1/contactGoals\",\n                \"automationLogs\": \"https://:account.api-us1.com/api/3/contactAutomations/1/automationLogs\"\n            },\n            \"id\": \"1\"\n        }\n    ],\n    \"meta\": {\n        \"total\": \"1\"\n    }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "contactAutomations": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "contact": {
                            "type": "string",
                            "example": "1"
                          },
                          "seriesid": {
                            "type": "string",
                            "example": "2"
                          },
                          "startid": {
                            "type": "string",
                            "example": "0"
                          },
                          "status": {
                            "type": "string",
                            "example": "1"
                          },
                          "batchid": {},
                          "adddate": {
                            "type": "string",
                            "example": "2026-01-14T09:12:44-06:00"
                          },
                          "remdate": {},
                          "timespan": {},
                          "lastblock": {
                            "type": "string",
                            "example": "5"
                          },
                          "lastlogid": {
                            "type": "string",
                            "example": "31"
                          },
                          "lastdate": {
                            "type": "string",
                            "example": "2026-01-14T09:12:44-06:00"
                          },
                          "in_als": {
                            "type": "string",
                            "example": "0"
                          },
                          "completedElements": {
                            "type": "string",
                            "example": "3"
                          },
                          "totalElements": {
                            "type": "string",
                            "example": "7"
                          },
                          "completed": {
                            "type": "string",
                            "example": "0"
                          },
                          "completeValue": {
                            "type": "string",
                            "example": "42"
                          },
                          "links": {
                            "type": "object",
                            "properties": {
                              "automation": {
                                "type": "string",
                                "example": "https://:account.api-us1.com/api/3/contactAutomations/1/automation"
                              },
                              "contact": {
                                "type": "string",
                                "example": "https://:account.api-us1.com/api/3/contactAutomations/1/contact"
                              },
                              "contactGoals": {
                                "type": "string",
                                "example": "https://:account.api-us1.com/api/3/contactAutomations/1/contactGoals"
                              },
                              "automationLogs": {
                                "type": "string",
                                "example": "https://:account.api-us1.com/api/3/contactAutomations/1/automationLogs"
                              }
                            }
                          },
                          "id": {
                            "type": "string",
                            "example": "1"
                          }
                        }
                      }
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "total": {
                          "type": "string",
                          "example": "1"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": false,
    "proxy-enabled": false
  },
  "x-readme-fauxas": true
}
```