Skip to main content
GET
/
v3
/
sequences
/
{id}
/
contacts
/
state
List contacts in sequence with extended state
curl --request GET \
  --url https://api.reply.io/v3/sequences/{id}/contacts/state \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "contactId": 150467348,
      "email": "john.doe@example.com",
      "firstName": "John",
      "lastName": "Doe",
      "title": "Important Client",
      "addedAt": "2025-10-29T10:00:00.00",
      "currentStep": {
        "stepId": 11111111,
        "displayStepNumber": "1",
        "stepNumber": 1
      },
      "lastStepCompletedAt": null,
      "status": {
        "status": "Active",
        "replied": false,
        "delivered": false,
        "bounced": false,
        "opened": false,
        "clicked": false
      }
    }
  ],
  "hasMore": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.reply.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Authenticate every request with a Bearer token. Pass your Reply API key in the Authorization header:

Authorization: Bearer <your-api-key>

Get your API key from the Reply dashboard: Settings → API Key.

Path Parameters

​
id
integer
required

Sequence ID

Query Parameters

​
top
integer

Maximum number of items to return (default 25, max 100)

​
skip
integer

Number of items to skip

​
additionalColumns
string

Comma-separated list of additional columns to include in the response. When omitted, only base fields are returned.

ColumnDescription
CurrentStepCurrent sequence step info (stepId, displayStepNumber, stepNumber)
LastStepCompletedAtTimestamp of the last completed step
StatusEngagement status with delivery/open/click/reply/bounce flags

Example: additionalColumns=CurrentStep,Status

Response

List of contacts with extended state data

Response model for listing contacts in a sequence with pagination

​
items
object[]

Array of sequence contact items

​
hasMore
boolean
read-only

Indicates if there are more items to fetch