Skip to main content
GET
/
{instance}
/
lids
/
pn
/
{phoneNumber}
Get LID by phone number
curl --request GET \
  --url https://app.hypersender.com/api/whatsapp/v2/{instance}/lids/pn/{phoneNumber} \
  --header 'Authorization: Bearer <token>'
{
  "lid": "1111111@lid",
  "pn": "[email protected]"
}
Resolves a phone-number-based chat ID to its linked identifier.
If you send the full @c.us value in the URL path, encode @ as %40. Example: 3333333%40c.us.
You can send either the full identifier, such as [email protected], or only the numeric part when that fits your integration.
If the mapping is missing, your instance does not currently know how to convert that @c.us value.

​
Response Example

{
  "lid": "1111111@lid",
  "pn": "[email protected]"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Accept
string

application/json

Example:

"application/json"

​
Content-Type
string

application/json

Example:

"application/json"

Path Parameters

​
instance
string
required

Instance UUID copied from hypersender dashboard

Example:

"{{ instance_id }}"

​
phoneNumber
string
required

The phone-number-based identifier to resolve. Encode @ as %40 when sending the full value in the path.

Example:

"3333333%40c.us"

Response

Successful response

​
lid
string
required

Linked identifier for the contact

Example:

"1111111@lid"

​
pn
string
required

Phone-number-based chat ID for the same contact

Example:

"[email protected]"