List Sequence Variants

List the A/B variants of a sequence step.

GEThttps://api.foxreach.io/api/v1/campaigns/{campaign_id}/sequences/{sequence_id}/variants

Requires an API key with the read scope.

A step with variants splits its recipients across them by weight. The step's own subject and body are used when it has no variants. The same variants also appear on each step returned by List Sequence Steps.

Path Parameters#

campaign_idstringpathrequired

The campaign.

sequence_idstringpathrequired

The sequence step.

Response#

The response data is an array of variant objects, ordered by label (fields as in Create Sequence Variant).

Errors#

Status	Description
`401`	Missing, invalid, revoked or expired API key
`403`	API key does not have the required scope: `read`
`404`	Campaign or sequence step not found in this workspace

Rate Limit#

300 requests per minute, shared by every read call in your workspace. Fixed 60-second window.
Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (unix epoch seconds) and X-RateLimit-Bucket (read).
A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns (Retry-After, exponential backoff, monitoring X-RateLimit-Remaining), see Rate Limiting.

Request

cURL

curl -X GET "https://api.foxreach.io/api/v1/campaigns/cmcamp1/sequences/cmseq1/variants" \
  -H "X-API-Key: otr_your_key"

Python SDK

from foxreach import FoxReach

client = FoxReach(api_key="otr_your_key")
variants = client.campaigns.sequences.list_variants("cmcamp1", "cmseq1")

TypeScript SDK

import { FoxReach } from "foxreach";

const client = new FoxReach({ apiKey: "otr_your_key" });
const variants = await client.campaigns.sequences.listVariants("cmcamp1", "cmseq1");

Response

JSON

{
  "data": [
    {
      "id": "cmvar1",
      "sequenceId": "cmseq1",
      "label": "A",
      "subject": "Quick question, {{firstName}}",
      "body": "Hi {{firstName}}, ...",
      "weight": 1,
      "sendAsHtml": false,
      "createdAt": "2026-11-04T09:00:00",
      "updatedAt": "2026-11-04T09:00:00"
    }
  ]
}

Was this page helpful?

View as MarkdownLast updated November 4, 2026