Skip to main content
GET
/
contacts
/
search
Search contacts by email
curl --request GET \
  --url https://api.reply.io/v3/contacts/search \
  --header 'X-API-Key: <api-key>'
[
  {
    "id": 12345,
    "email": "[email protected]",
    "firstName": "John",
    "lastName": "Doe",
    "fullName": "John Doe",
    "title": "Senior Product Manager",
    "company": "Tech Solutions Inc",
    "domain": "company.com",
    "city": "San Francisco",
    "state": "CA",
    "country": "United States",
    "timeZone": "America/Los_Angeles",
    "phone": "+1-415-555-0123",
    "phoneStatus": "verified",
    "linkedInProfile": "https://www.linkedin.com/in/johndoe",
    "linkedInSalesNavigator": "https://www.linkedin.com/sales/profile/123456",
    "linkedInRecruiter": "https://www.linkedin.com/recruiter/profile/789012",
    "companySize": "501-1000",
    "industry": "Software & Technology",
    "notes": "Met at SaaS Conference 2024",
    "addingDate": "2024-03-08T10:00:00Z",
    "customFields": [
      {
        "key": "leadSource",
        "value": "Conference"
      },
      {
        "key": "budget",
        "value": "100k-250k"
      }
    ]
  }
]

Authorizations

​
X-API-Key
string
header
required

API key passed in the X-API-Key header

Query Parameters

​
email
string
required

Email address to search for

Response

200 - application/json

Search results retrieved successfully

​
firstName
string
required

First name

​
id
integer

Unique ID

​
email
string<email>

Primary email address

​
lastName
string

Last name

​
phone
string

Phone number

​
title
string

Job title

​
company
string

Organization name

​
companySize
string

Organization employee count

​
industry
string

Business sector

​
linkedInProfile
string<uri>

LinkedIn profile URL

​
linkedInSalesNavigator
string<uri>

Sales Navigator URL

​
linkedInRecruiter
string<uri>

Recruiter URL

​
city
string

City of residence

​
state
string

State/province

​
country
string

Country

​
timeZone
string

Timezone identifier

​
domain
string

Email domain

​
phoneStatus
string

Phone validation status

​
notes
string

Additional information

​
addingDate
string<date-time>

Creation timestamp

​
customFields
object[]

User-defined fields