Skip to main content
GET
/
{instance}
/
lids
/
{lid}
Get phone number by LID
curl --request GET \
  --url https://app.hypersender.com/api/whatsapp/v2/{instance}/lids/{lid} \
  --header 'Authorization: Bearer <token>'
{
  "lid": "1111111@lid",
  "pn": "[email protected]"
}
Resolves a linked identifier to its phone-number-based chat ID.
If you send the full @lid value in the URL path, encode @ as %40. Example: 1111111%40lid.
You can send either the full identifier, such as 1111111@lid, 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 @lid 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 }}"

​
lid
string
required

The linked identifier to resolve. Encode @ as %40 when sending the full value in the path.

Example:

"1111111%40lid"

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]"