Skip to main content
GET
/
contacts
List all contacts
curl --request GET \
  --url https://api.reply.io/v3/contacts \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "id": 12345,
      "email": "john.doe@company.com",
      "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"
        }
      ]
    }
  ],
  "pagination": {
    "total": 123,
    "pages": 123,
    "currentPage": 123,
    "limit": 123
  }
}

Authorizations

X-API-Key
string
header
required

API key passed in the X-API-Key header

Query Parameters

top
integer

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

skip
integer

Number of contacts to skip

email
string

Filter contacts by email address

linkedIn
string

Filter contacts by LinkedIn profile URL

Response

200 - application/json

List of contacts retrieved successfully

data
object[]
pagination
object