Get Chat ID From Phone Number

Supported & Tested

Convert a phone number into a WhatsApp chat ID (JID). The endpoint automatically formats local and international numbers and can verify whether the number is registered on WhatsApp.

POSThttps://api.waplix.io/api/v1/number/chat-id

Authentication

Authorization: Bearer YOUR_API_KEY

Parameters Specification

Parameter	Type	Required	Description
instance_id	`string`	Required	Required Waplix instance id
phone_number	`string`	Optional	Phone number in local or international format
country_code	`string`	Optional	Optional country code used when formatting local numbers

instance_id

stringReq

Required Waplix instance id

phone_number

stringOpt

Phone number in local or international format

country_code

stringOpt

Optional country code used when formatting local numbers

Usage Notes

Converts a phone number into a WhatsApp chat ID/JID. Confirms whether the number exists and is registered on WhatsApp. Returns chat_id, jid, and verified_jid. Verified on production instance 29854.

Request Payload Example

Request

curl -X POST "https://api.waplix.io/api/v1/api/v1/number/chat-id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "instance_id": "demo_instance",
  "phone_number": "15551234567"
}'

Success Response

Response · 200 OK

{
  "success": true,
  "data": {
    "input": "15551234567",
    "country_code": null,
    "formatted_number": "15551234567",
    "chat_id": "15551234567@s.whatsapp.net",
    "jid": "15551234567@s.whatsapp.net",
    "type": "user",
    "is_registered": true,
    "exists": true,
    "verified_jid": "15551234567@s.whatsapp.net"
  }
}

Previous Get All Contacts Next Get Country Code

Was this page helpful?