---
title: Find Contact | API Docs
---

GET

/api/partner/v2/contacts/find

Select code sample cURL (shell:curl)

```
const url = 'https://api.linqapp.com/api/partner/v2/contacts/find?email=john%40example.com&phone_number=%2B15551234567';
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/find?email=john%40example.com&phone_number=%2B15551234567' \
  --header 'X-LINQ-INTEGRATION-TOKEN: <X-LINQ-INTEGRATION-TOKEN>'
```

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

Finds a contact by email or phone number. At least one search parameter must be provided.

If both email and phone\_number are provided, the search uses OR logic (returns the contact if either matches).

**Phone Number Handling:** Phone numbers are automatically normalized to E.164 format before searching. You can provide phone numbers in various formats (e.g., “(555) 123-4567”, “555-123-4567”, “+15551234567”) and they will be normalized for matching.

## Authorizations

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

## Parameters

### Query Parameters

**email**

string format: email

Email address to search for

##### Example

```
john@example.com
```

**phone\_number**

string

Phone number to search for. The API will automatically normalize it to E.164 format for searching (e.g., “+15551234567”).

##### Example

```
+15551234567
```

## Responses

### 200

Successful response (returns contact if found, or null if not found)

Media type application/json

One of:

- [object](#tab-panel-2)
- [object](#tab-panel-3)

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

object

**contact**

null

##### Examples

Select example contact\_found

Contact found

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

Contact not found

```
{
  "contact": null
}
```

### 400

Bad request - Missing search parameters (client-side error). Please verify all required parameters are included and properly formatted.

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": "MISSING_SEARCH_PARAMS",
  "message": "At least one search parameter is required",
  "errors": [
    "Please provide either email or phone_number"
  ]
}
```

### 422

Validation error - Invalid email or phone format

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>

##### Examples

Select example invalid\_email

Invalid email format

```
{
  "status": "error",
  "error_code": "INVALID_EMAIL_FORMAT",
  "message": "Invalid email format",
  "errors": [
    "The provided email address is not in a valid format"
  ]
}
```

Invalid phone format

```
{
  "status": "error",
  "error_code": "INVALID_PHONE_FORMAT",
  "message": "Invalid phone number format",
  "errors": [
    "The provided phone number is not in a valid format. Please use E.164 format (e.g., +15551234567)"
  ]
}
```

### 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 find contact",
  "errors": [
    "Internal server error. Please try again or contact support if the issue persists."
  ]
}
```