Skip to main content
GET
/
v1
/
contacts
/
{contact_id}
Get Contact
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.topo.io/v1/contacts/{contact_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "first_seen_at": "2023-11-07T05:31:56Z",
  "last_seen_at": "2023-11-07T05:31:56Z",
  "email": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "job_title": "<string>",
  "linkedin_url": "<string>",
  "phone_number": "<string>",
  "city": "<string>",
  "state": "<string>",
  "country": "<string>",
  "profile_picture_url": "<string>",
  "company_name": "<string>",
  "company_domain": "<string>"
}

Authorizations

Authorization
string
header
required

Bearer API key issued from Settings โ†’ Developers.

Path Parameters

contact_id
string<uuid>
required

ID of the contact.

Response

200 - application/json

Successful Response

id
string<uuid>
required

Unique identifier of the contact.

first_seen_at
string<date-time>
required

When this person was first associated with the organization.

last_seen_at
string<date-time>
required

When this person was last touched in the organization.

email
string | null

Email.

first_name
string | null

First name.

last_name
string | null

Last name.

job_title
string | null

Job title.

linkedin_url
string | null

LinkedIn profile URL.

phone_number
string | null

Phone number.

city
string | null

City.

state
string | null

State.

country
string | null

Country.

profile_picture_url
string | null

Profile picture URL.

company_name
string | null

Employer name.

company_domain
string | null

Employer's primary domain.