Lire une série

GET /api/v1/series/{seriesId} Lit une série. Répond 400 quand l'identifiant appartient à une séquence d'inscription plutôt qu'à une série — une date de départ nulle et une audience vide auraient ressemblé à une série mal configurée, au lieu du mauvais type d'objet.

Autorisation

RôleAccès
OWNERAutorisé
ADMINAutorisé
MEMBERAutorisé

Paramètres de chemin

ParamètreTypeDescription
seriesIdstring (uuid)L'identifiant de la série — c'est aussi celui de sa séquence

Exemple

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

Réponse

CodeQuand
200La série
400Cet identifiant est celui d'une séquence, pas d'une série
401Clé absente ou invalide
404Aucune série avec cet identifiant dans votre organisation

Champs de la réponse

Même forme que lister les séries, pour l'objet unique contenu dans data.

Exemple de réponse

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"
  }
}

Remarques

Les étapes ne figurent pas dans cette réponse. Lisez-les avec GET /api/v1/sequences/{seriesId}/versions/{versionId}/nodes — chaque étape d'envoi porte son sendTimeMinutes, et chaque attente son waitHours.

Voir aussi