---
title: "Batch phone lookup"
method: POST
path: "/api/v1/contacts/from-phone"
tags: ["Lookup"]
---

# Batch phone lookup

`POST /api/v1/contacts/from-phone`

## Request

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

Look up contacts by phone numbers. 1 credit per successful match.

## Request body

- object
  - `items` object[], required
    - `phone` string
    - `cellphone` string
  - `limit_per_item` integer

## Response `200`

Batch results

- object
  - `ok` boolean
  - `results` object[]
    - `phone` string
    - `cellphone` string
    - `success` boolean
    - `data` Contact: Contact record. Fields vary based on dataset and column selection.
    - `skipped_reason` string
  - `creditsRemaining` integer, nullable
  - `credits_exhausted` boolean
  - `message` string
  - `code` string

## Other responses

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