> ## Documentation index
> Fetch the complete documentation index at: https://leadmcp.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Look up one phone number

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

Authentication: API key.

Query param `phone` or `cellphone`. Returns the full `releases` row in `data` when found; `success: false` with no charge when not found.

### Query parameters

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `phone` | string | yes |  | Pass this as a query string value. |
| `cellphone` | string | yes |  | Pass this as a query string value. |

### Response fields

| Field | Type | Description |
| --- | --- | --- |
| `ok` | boolean | True when the request succeeded. |
| `success` | boolean | True when this request found a match. |
| `data` | object | The matched record, or null when nothing matched. |
| `creditsRemaining` | number | Plan credits left after this request. Null on unlimited plans. |

### Example request

```bash
curl -sS "https://leadmcp.ai/api/v1/contacts/lookup/phone?phone=%2B1+415-555-0142" \
  -H "X-API-Key: lb_live_YOUR_API_KEY"
```

### Example response (200)

```json
{
  "ok": true,
  "success": true,
  "data": {
    "first_name": "Jane",
    "last_name": "Doe",
    "email_address": "jane@acme.com",
    "cellphone": "+1 415-555-0142",
    "domain_org": "acme.com"
  },
  "creditsRemaining": 4999
}
```