Contacts

Contacts are how you'll access our catalog of qualified sales leads.

The contact object contains all the information about out contacts, such as their LinkedIn url, phone number and locality.

Properties

Name
id
Type
string
Description
Our unique identifier for the contact.
Name
linkedin_url
Type
string
Description
The LinkedIn URL for the contact.
Name
phone_number
Type
string
Description
The phone number for the contact.
Name
company_logo
Type
string
Description
The URL for the company's logo.
Name
locality
Type
string
Description
The contact's locatio. E.g Dublin.
Name
last_updated
Type
timestamp
Description
Timestamp of when the contact was last updates.
Name
created_at
Type
timestamp
Description
Timestamp of when the contact was created.

GET/v1/contacts

List all contacts

This endpoint allows you to retrieve a paginated list of all your contacts. By default, a maximum of ten contacts are shown per page.

Optional attributes

Name
limit
Type
integer
Description
Limit the number of contacts returned.

Request

GET

/v1/contacts

curl -G https://api.deepvalue.ie/v1/contacts \
  -H "Authorization: Bearer {token}" \
  -d active=true \
  -d limit=10

Response

{
  "has_more": false,
  "data": [
    {
      "id": "1",
      "linkedin_url": "John Kennedy",
      "phone_number": "000-000-0000",
      "company_logo": "https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png",
      "locality": "Dublin",
      "last_updated": 705103200,
      "created_at": 692233200
    },
    {
      "id": "2"
      // ...
    }
  ]
}

GET/v1/contacts/:id

Retrieve a specific contact

This endpoint allows you to retrieve a contact by providing their id. Refer to the list at the top of this page to see which properties are included with contact objects.

Request

GET

/v1/contacts/1

curl https://api.deepvalue.ie/v1/contacts/1 \
  -H "Authorization: Bearer {token}"

Response


  {
    "id": "1",
    "linkedin_url": "John Kennedy",
    "phone_number": "000-000-0000",
    "company_logo": "https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png",
    "locality": "Dublin",
    "last_updated": 705103200,
    "created_at": 692233200
  }