Sign in

v1

latestOpenAPI 3.1.02026-07-26359254.7 MB
Contacts

Get a contact

<small>Requires the contacts:read scope (or a broader one that includes it).</small>

Use this endpoint when you need the full record of a single contact, identified by its Reply contact id — including profile fields, owner, opt-out, call and meeting status, and all custom field values.

get/v3/contacts/{id}

Path parameters

idinteger required

Contact ID

Response

Contact details retrieved successfully

idinteger

Unique ID

emailstring email

Primary email address

domainstring

Email domain (derived from email)

firstNamestring

First name

lastNamestring

Last name

phonestring

Phone number

titlestring

Job title

companystring

Organization name

companySize'empty' | 'selfEmployed' | 'ten' | 'fifty' | 'twoHundred' | 'fiveHundred' | 'oneThousand' | 'fiveThousand' | 'tenThousand' | 'overTenThousand'

Organization employee count range

industrystring

Business sector

citystring

City of residence

statestring

State/province

countrystring

Country

timeZoneIdstring

Timezone identifier

linkedInUrlstring uri

LinkedIn profile URL

linkedInSalesNavigatorUrlstring uri

Sales Navigator URL

linkedInRecruiterUrlstring uri

Recruiter URL

phoneStatus'pending' | 'invalid' | 'valid' | 'validationFailed' | 'notValidated'

Phone validation status

notesstring

Additional information

ownerUserIdinteger

ID of the user who owns this contact

accountIdinteger nullable

ID of the contact account this contact belongs to

isOptedOutboolean

Whether the contact has opted out of communications

callStatus'none' | 'toCall' | 'called'

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

meetingStatus'none' | 'meetingBooked'

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

addingDatestring date-time nullable

Date the contact was added

createdAtstring date-time nullable

Creation timestamp

lastModifiedAtstring date-time nullable

Last modification timestamp

Example response

{
  "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"
    }
  ]
}