Get a series

GET /api/v1/series/{seriesId} Reads one series. Answers 400 when the id belongs to an enrollment sequence rather than a series — a null start date and an empty audience would have looked like a badly configured series instead of the wrong kind of object.

Authorization

RoleAccess
OWNERAllowed
ADMINAllowed
MEMBERAllowed

Path parameters

ParameterTypeDescription
seriesIdstring (uuid)The series id — also its sequence id

Example

bash
curl -s 'https://www.agentsmail.io/api/v1/series/7d7d7d7d-8888-4ccc-9ddd-eeee00001111' \
  -H "x-api-key: $AGENTMAIL_API_KEY"

Response

CodeWhen
200The series
400This id is a sequence, not a series
401Missing or invalid key
404No series with this id in your organization

Response fields

Same shape as list series, for the single object in data.

Example response

json
{
  "success": true,
  "data": {
    "id": "7d7d7d7d-8888-4ccc-9ddd-eeee00001111",
    "name": "March launch",
    "status": "active",
    "startsAt": "2026-03-15T08:00:00.000Z",
    "listId": "9f8e7d6c-1111-4bbb-8ccc-ddddeeeeffff",
    "audienceSegmentId": null,
    "audienceTagId": null,
    "topicId": null,
    "createdAt": "2026-03-01T10:00:00.000Z",
    "updatedAt": "2026-03-02T10:00:00.000Z"
  }
}

Notes

The steps are not in this response. Read them with GET /api/v1/sequences/{seriesId}/versions/{versionId}/nodes — each sending step carries its sendTimeMinutes, and each wait its waitHours.