List contacts in sequence

curl --request GET \
  --url https://api.reply.io/v3/sequences/{id}/contacts \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.reply.io/v3/sequences/{id}/contacts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.reply.io/v3/sequences/{id}/contacts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.reply.io/v3/sequences/{id}/contacts"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.reply.io/v3/sequences/{id}/contacts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "contactId": 12345,
      "sequenceId": 100,
      "email": "john.doe@company.com",
      "firstName": "John",
      "lastName": "Doe",
      "company": "Tech Solutions Inc",
      "title": "Senior Product Manager",
      "statusInSequence": "active",
      "isOptedOut": false,
      "callStatus": "none",
      "meetingStatus": "none",
      "emailDisposition": {
        "isReplied": false,
        "isBounced": false
      },
      "currentStep": {
        "stepId": 5421,
        "displayName": "2"
      },
      "addingDate": "2024-03-08T10:00:00+00:00",
      "emailAccountId": 101,
      "linkedInAccountId": null
    }
  ],
  "hasMore": true
}

Sequence Contacts

List contacts in sequence

Requires the sequences:read scope (or a broader one that includes it).

Use this endpoint when you need to see who is enrolled in a sequence and where each contact stands in it. Every entry carries the contact’s identity fields together with its statusInSequence, the currentStep it is waiting on, addingDate, whether it is opted out, its call and meeting status, the emailDisposition telling you whether it has replied or bounced, and the email and LinkedIn accounts assigned to it. Results come back as a page controlled by the top and skip query parameters; omit both to get the first page. Contacts are ordered most-recently-added first unless you pass sort_by, which sorts descending by default — pass sort_direction to change that.

GET

sequences

{id}

contacts

List contacts in sequence

curl --request GET \
  --url https://api.reply.io/v3/sequences/{id}/contacts \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.reply.io/v3/sequences/{id}/contacts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.reply.io/v3/sequences/{id}/contacts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.reply.io/v3/sequences/{id}/contacts"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.reply.io/v3/sequences/{id}/contacts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "contactId": 12345,
      "sequenceId": 100,
      "email": "john.doe@company.com",
      "firstName": "John",
      "lastName": "Doe",
      "company": "Tech Solutions Inc",
      "title": "Senior Product Manager",
      "statusInSequence": "active",
      "isOptedOut": false,
      "callStatus": "none",
      "meetingStatus": "none",
      "emailDisposition": {
        "isReplied": false,
        "isBounced": false
      },
      "currentStep": {
        "stepId": 5421,
        "displayName": "2"
      },
      "addingDate": "2024-03-08T10:00:00+00:00",
      "emailAccountId": 101,
      "linkedInAccountId": null
    }
  ],
  "hasMore": true
}

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

integer

required

Sequence ID

Query Parameters

top

integer

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

skip

integer

Number of items to skip

sort_by

enum<string>

Field name to sort results by. Each value matches the corresponding response field. When omitted, results are ordered most-recently-added first.

Available options:

addingDate,

email,

firstName,

lastName,

company,

statusInSequence

sort_direction

enum<string>

Sort direction (asc or desc). Defaults to desc when sort_by is provided.

Available options:

asc,

desc

Response

List of contacts in sequence

Response model for listing contacts in a sequence with pagination

items

Sequence Contact · object[]

Array of sequence contact items

Show child attributes

hasMore

boolean

read-only

Indicates if there are more items to fetch

Getting started

For AI agents

API Documentation

Schemas

Webhooks

Machine-readable

List contacts in sequence

Authorizations

Path Parameters

Query Parameters

Response