Get LIDs Mapping

Retrieves all known LID to phone number mappings.

GET
https://api.wawp.net/v2/lids?instance_id=123456789&access_token=123456789&limit=100&offset=0

Authentication Required

Login to swap the placeholders with your real Instance ID and Access Token.

Log In
Test /v2/lids endpoint
GET
GET

No query parameters required

This endpoint doesn't expect data in the URL.

Best practices

  • Run this periodically to ensure your ID map is consistent.

  • Use background workers to process the list.

Request Parameters

Configure the parameters required to interact with this endpoint. All query and body arguments are listed below with their details.

URL Parameters

Passed in the URL query string
string

Your unique WhatsApp Instance ID

Example:
string

Your API Access Token

Example:
string

Maximum number of mappings to return

Example:
string

Number of mappings to skip

Example:

Request Samples

Use these ready-to-go code snippets to integrate our API into your project quickly and efficiently. Choose your preferred language and library.

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/lids";
3const params = new URLSearchParams({
4 "instance_id": "123456789",
5 "access_token": "123456789",
6 "limit": "100",
7 "offset": "0"
8}).toString();
9
10
11fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
12 method: "GET",
13 headers: { "Content-Type": "application/json" },
14
15})
16 .then(async (response) => {
17 if (response.ok) {
18 const data = await response.json();
19 console.log("Success:", data);
20 return data;
21 }
22
23 // Error Handling
24 if (response.status === 401) {
25 console.error("Error 401: Unauthorized - Invalid or Missing Access Token");
26 }
27 if (response.status === 400) {
28 console.error("Error 400: Bad Request - Invalid Parameter Format");
29 }
30 if (response.status === 500) {
31 console.error("Error 500: Internal Server Error - Unexpected Failure");
32 }
33
34 const errorText = await response.text();
35 console.error(`Error ${response.status}: ${errorText}`);
36 })
37 .catch((error) => console.error("Network Error:", error));
Interactive Samples
Ln 37, Col 1javascript

Expected Responses

Explore all possible responses and outcomes from the server. We have documented each status code with data examples to make success and error handling easier.

LIDs mapped successfully
application/json
object *

Example

{
"0": {
  "lid": "1234567890@lid",
  "number": "1234567890"
  }
}
Bad Request - Invalid Parameter Format
Unauthorized - Invalid or Missing Access Token
Internal Server Error - Unexpected Failure
Previous TopicCreate/Update Contact
Next TopicGet LID by Phone

Command Palette

Search for a command to run...