Skip to main content
GET
/
v3
/
contacts
/
{id}
Get a contact
curl --request GET \
  --url https://api.reply.io/v3/contacts/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": 12345,
  "email": "john.doe@company.com",
  "firstName": "John",
  "lastName": "Doe",
  "title": "Senior Product Manager",
  "company": "Tech Solutions Inc",
  "domain": "company.com",
  "companySize": "oneThousand",
  "city": "San Francisco",
  "state": "CA",
  "country": "United States",
  "timeZoneId": "America/Los_Angeles",
  "phone": "+1-415-555-0123",
  "phoneStatus": "valid",
  "linkedInUrl": "https://www.linkedin.com/in/johndoe",
  "linkedInSalesNavigatorUrl": "https://www.linkedin.com/sales/profile/123456",
  "linkedInRecruiterUrl": "https://www.linkedin.com/recruiter/profile/789012",
  "industry": "Software & Technology",
  "notes": "Met at SaaS Conference 2024",
  "ownerUserId": 42,
  "accountId": 100,
  "isOptedOut": false,
  "callStatus": "toCall",
  "meetingStatus": "none",
  "addingDate": "2024-03-08T10:00:00+00:00",
  "createdAt": "2024-03-08T10:00:00",
  "lastModifiedAt": "2024-03-10T15:30:00",
  "customFields": [
    {
      "key": "leadSource",
      "value": "Conference"
    },
    {
      "key": "budget",
      "value": "100k-250k"
    }
  ],
  "sequences": [
    {
      "sequenceId": 100,
      "sequenceName": "Sales Outreach",
      "status": "active",
      "currentStep": 2,
      "addingDate": "2024-03-08T10:00:00+00:00",
      "emailAccountId": 101,
      "linkedInAccountId": null
    }
  ],
  "lists": [
    {
      "listId": 10,
      "listName": "Hot Leads",
      "isShared": 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 details retrieved successfully

Contact response model

​
id
integer
read-only

Unique ID

​
email
string<email>

Primary email address

​
domain
string
read-only

Email domain (derived from email)

​
firstName
string

First name

​
lastName
string

Last name

​
phone
string

Phone number

​
title
string

Job title

​
company
string

Organization name

​
companySize
enum<string>

Organization employee count range

Available options:
empty,
selfEmployed,
ten,
fifty,
twoHundred,
fiveHundred,
oneThousand,
fiveThousand,
tenThousand,
overTenThousand
​
industry
string

Business sector

​
city
string

City of residence

​
state
string

State/province

​
country
string

Country

​
timeZoneId
string

Timezone identifier

​
linkedInUrl
string<uri>

LinkedIn profile URL

​
linkedInSalesNavigatorUrl
string<uri>

Sales Navigator URL

​
linkedInRecruiterUrl
string<uri>

Recruiter URL

​
phoneStatus
enum<string>

Phone validation status

Available options:
pending,
invalid,
valid,
validationFailed,
notValidated
​
notes
string

Additional information

​
ownerUserId
integer

ID of the user who owns this contact

​
accountId
integer | null

ID of the contact account this contact belongs to

​
isOptedOut
boolean
read-only

Whether the contact has opted out of communications

​
callStatus
enum<string>

Contact-level call status

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

Contact-level meeting status

Available options:
none,
meetingBooked
​
addingDate
string<date-time> | null
read-only

Date the contact was added

​
createdAt
string<date-time> | null
read-only

Creation timestamp

​
lastModifiedAt
string<date-time> | null
read-only

Last modification timestamp

​
customFields
object[]

User-defined fields

​
sequences
object[]
read-only

Sequences the contact is enrolled in

​
lists
object[]
read-only

Lists the contact belongs to