---
title: "Lookup contact by phone number"
method: GET
path: "/api/v1/contacts/lookup/phone"
tags: ["Lookup"]
---

# Lookup contact by phone number

`GET /api/v1/contacts/lookup/phone`

## Request

- Base URL: `https://app.getleads.io`
- URL: `https://app.getleads.io/api/v1/contacts/lookup/phone`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Single phone/cellphone lookup. 1 credit if found.

## Query parameters

- `phone` string
- `cellphone` string

## Response `200`

Lookup result

- object
  - `ok` boolean
  - `success` boolean
  - `data` Contact: Contact record. Fields vary based on dataset and column selection.
  - `creditsRemaining` integer, nullable

## Other responses

- `400`: Validation error
- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/getleads/apis/getleads-api.md) - [All operations](https://skmtc.dev/getleads/apis/getleads-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getleads/apis/getleads-api/revisions/f5dbc32e0c3a?raw)