List Contacts

V2 Reference

Contacts

GET

/api/partner/v2/contacts

const url = 'https://api.linqapp.com/api/partner/v2/contacts?page=1&per_page=25';
const options = {
  method: 'GET',
  headers: {'X-LINQ-INTEGRATION-TOKEN': '<X-LINQ-INTEGRATION-TOKEN>'}
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.linqapp.com/api/partner/v2/contacts?page=1&per_page=25' \
  --header 'X-LINQ-INTEGRATION-TOKEN: <X-LINQ-INTEGRATION-TOKEN>'

Retrieves a paginated list of all contacts in your organization

Authorizations

ApiKeyAuth

Parameters

Query Parameters

page

integer

default: 1

Page number for pagination (default 1)

per_page

integer

default: 25 <= 100

Number of items per page (default 25, max 100)

Responses

200

Successful response

application/json

object

contacts

Array<object>

object

integer

first_name

string

last_name

string

full_name

string

email

string

phone_number

string

company

string

title

string

location

string

image_url

string

nullable

created_at

string format: date-time

updated_at

string format: date-time

contact_owner

The user who owns this contact in your organization

object

integer

email

string

first_name

string

last_name

string

name

string

pagination

object

current_page

integer

per_page

integer

total_pages

integer

total_count

integer

Example

{
  "contacts": [
    {
      "id": 123,
      "first_name": "John",
      "last_name": "Doe",
      "full_name": "John Doe",
      "email": "[email protected]",
      "phone_number": "+15551234567",
      "company": "Acme Corp",
      "title": "CEO",
      "location": "San Francisco, CA",
      "image_url": null,
      "created_at": "2025-07-30T10:00:00.000-05:00",
      "updated_at": "2025-07-30T10:00:00.000-05:00",
      "contact_owner": {
        "id": 456,
        "email": "[email protected]",
        "first_name": "Jane",
        "last_name": "Owner",
        "name": "Jane Owner"
      }
    },
    {
      "id": 124,
      "first_name": "Jane",
      "last_name": "Smith",
      "full_name": "Jane Smith",
      "email": "[email protected]",
      "phone_number": "+15559876543",
      "company": "Tech Corp",
      "title": "CTO",
      "location": "New York, NY",
      "image_url": null,
      "created_at": "2025-07-29T10:00:00.000-05:00",
      "updated_at": "2025-07-29T10:00:00.000-05:00",
      "contact_owner": {
        "id": 456,
        "email": "[email protected]",
        "first_name": "Jane",
        "last_name": "Owner",
        "name": "Jane Owner"
      }
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 25,
    "total_pages": 5,
    "total_count": 123
  }
}

500

Internal server error

application/json

Alternative error format used by Contacts and Webhook Subscriptions endpoints (render_standard_error format)

object

status

string

error_code

string

message

string

errors

Array<string>

Example

{
  "status": "error",
  "error_code": "INTERNAL_ERROR",
  "message": "Unable to fetch contacts",
  "errors": [
    "Internal server error. Please try again or contact support if the issue persists."
  ]
}