Skip to main content
GET
/
v3
/
contacts
/
{id}
/
statuses
Get a contact's statuses
curl --request GET \
  --url https://api.reply.io/v3/contacts/{id}/statuses \
  --header 'Authorization: Bearer <token>'
{
  "contactId": 12345,
  "isOptedOut": false,
  "callStatus": "toCall",
  "meetingStatus": "none",
  "sequences": [
    {
      "sequenceId": 100,
      "sequenceName": "Sales Outreach",
      "statusInSequence": "active",
      "emailDisposition": {
        "isReplied": false,
        "isBounced": false
      }
    },
    {
      "sequenceId": 101,
      "sequenceName": "Re-engagement",
      "statusInSequence": "finished",
      "emailDisposition": {
        "isReplied": true,
        "isBounced": false
      }
    }
  ]
}

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

Contact ID

Response

Contact statuses retrieved successfully

​
contactId
integer
required

Contact ID

​
isOptedOut
boolean
required

Whether the contact has opted out of all communications

​
callStatus
enum<string>
required

Contact-level call status. Set via PATCH /v3/contacts/{id} (callStatus field). Pass none to clear.

Available options:
none,
toCall,
called
​
meetingStatus
enum<string>
required

Contact-level meeting status. Set via PATCH /v3/contacts/{id} (meetingStatus field). Pass none to clear.

Available options:
none,
meetingBooked
​
sequences
object[]
required

Per-sequence status for every sequence the contact is enrolled in. Empty when the contact is not in any sequence.