<!-- Source: https://docs.vinsi.ai/api-docs/crm-contact-lookup-by-phone -->
# Find Contact by Phone

Find the first CRM contact whose phone, phone2 or phone3 matches the given number. Matching uses the last 10 digits, so formatting and country code are ignored (at least 7 digits are required). Returns 404 when no contact matches. lastAICallDisposition is the disposition of an AI call to that number that was transferred in the last 2 minutes, or null.

```http
GET https://dashboard.vinsi.ai/api/crm/contacts/lookup-by-phone?phone={phone}
```

## Authentication

Send your API key in the `x-api-key` header. Create keys in the VINSI dashboard under Settings → API Keys.

## Headers

| Name | Type | Required |
|---|---|---|
| Content-Type | string | yes (application/json) |
| x-api-key | string | yes |

## Query parameters

| Name | Required | Example |
|---|---|---|
| phone | yes | +15555550142 |

## Example request

```bash
curl -X GET 'https://dashboard.vinsi.ai/api/crm/contacts/lookup-by-phone?phone=+15555550142' \
  -H 'x-api-key: YOUR_API_KEY'
```

## Example response

```json
{
  "id": 1042,
  "firstName": "Alex",
  "lastName": "Morgan",
  "email": "alex.morgan@example.com",
  "company": "Acme Dental",
  "phone": "+15555550142",
  "phone2": "",
  "phone3": "",
  "lastAICallDisposition": null
}
```