---
title: List Contacts | API Docs
---

GET

/api/partner/v2/contacts

Select code sample cURL (shell:curl)

```
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>'
```

- Production server api.linqapp.com/api/partner/v2/contacts

Retrieves a paginated list of all contacts in your organization

## Authorizations

- **[ApiKeyAuth](/v2/api/#apikeyauth/index.md)**

## 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

Media type application/json

object

**contacts**

Array\<object>

object

**id**

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

**id**

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": "john@example.com",
      "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": "owner@company.com",
        "first_name": "Jane",
        "last_name": "Owner",
        "name": "Jane Owner"
      }
    },
    {
      "id": 124,
      "first_name": "Jane",
      "last_name": "Smith",
      "full_name": "Jane Smith",
      "email": "jane@example.com",
      "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": "owner@company.com",
        "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

Media type 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."
  ]
}
```