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

# WhatsApp Number Validator API

> Validate phone numbers against WhatsApp: check whether each number is registered, whether it is a business or personal account, and the public profile and business details the account shows.

`POST /v1/data/whatsapp/numbers/run`

**Pricing:** $0.01 per number ($10.50 per 1,000).

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**phoneNumbers** `string[]` *required*

Phone numbers to validate, each with + and the country code, for example +14155552671. Spaces, dashes, dots and brackets are fine, and 00 works in place of +. A number without its country code may be read as another country's number. Up to 1,000 numbers per request; one row per distinct number.

Up to 1000 items.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/whatsapp/numbers/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "phoneNumbers": [
      "+917070022222",
      "+918640086400",
      "+31206490787"
    ]
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/whatsapp/numbers/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "phoneNumbers": [
        "+917070022222",
        "+918640086400",
        "+31206490787"
    ]
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/whatsapp/numbers/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "phoneNumbers": [
    "+917070022222",
    "+918640086400",
    "+31206490787"
  ]
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one number, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `phone` | Phone | text |
| `hasWhatsapp` | Has WhatsApp | boolean |
| `accountType` | Account Type | text |
| `checkStatus` | Check Status | text |
| `business` | Business | object |
| `profile` | Profile | object |
| `identity` | Identity | object |
| `devices` | Devices | object |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "whatsapp/numbers",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "phone": "+917070022222",
      "identity": {
        "countryCode": "IN",
        "lid": "169419330343157@lid"
      },
      "checkStatus": "ok",
      "hasWhatsapp": true,
      "accountType": "business",
      "profile": {
        "about": "Official WhatsApp number of HDFC Bank: Convenient & secure platform for transactions, with robust encryption & authentication protocols.",
        "aboutRestricted": false
      },
      "business": {
        "displayName": "HDFC Bank Ltd",
        "description": "Welcome to ChatBanking on WhatsApp Made Digital By HDFC Bank NOW!\nAccess 180+ Banking services anytime anywhere 24X7. Save our WhatsApp number - 7070022222",
        "categories": [],
        "email": "support@hdfc.bank.in",
        "websites": [
          "https://www.hdfc.bank.in/"
        ],
        "address": "HDFC Bank House, Shiv Sagar Estate, Dr. Annie Besant Rd, Worli, Mumbai-400018",
        "latitude": null,
        "longitude": null,
        "timezone": null,
        "hours": [],
        "memberSince": "Joined in June, 2022",
        "memberSinceTs": 1655372957,
        "businessType": "ent",
        "verifiedLevel": "high",
        "cartEnabled": true,
        "commerceExperience": "none",
        "automatedType": "unknown",
        "linkedFacebookPage": {
          "id": "136617136381867",
          "name": "HDFC Bank",
          "likes": 2856378
        }
      },
      "devices": {
        "count": 1,
        "hosted": false
      }
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.