contact

get contact LID and phone

Resolves the mapping between a contact's Linked ID (LID) and phone number. Works in both directions: pass phone-number IDs (number@c.us) to get their LID, or pass Linked IDs (number@lid) to get the phone number. Returns an array of contact objects with their LID and phone number (pn) mappings.

post/instances/{id}/client/action/get-lid

Request

Base URL: https://waapi.app/api/v1
URL: https://waapi.app/api/v1/instances/{id}/client/action/get-lid
Auth: HTTP bearer

Path parameters

idinteger required

Instance ID

Request body

contactIdsstring[] required

Array of contact IDs to resolve. Accepts both phone-number IDs (number@c.us) and Linked IDs (number@lid) — resolution works in either direction.

Example request

{
  "contactIds": [
    "491729682587@c.us",
    "169724423991411@lid"
  ]
}

Response

Request reached the instance. data.status reports whether the action was carried out; on error data carries message and explanation. Payload: Contact LID and phone information retrieved successfully.

status'success' | 'error'

Whether the request reached the instance. success here does not mean the action was carried out — that is reported by data.status, which is the authoritative one. A malformed input arrives as status: success with data.status: error.

Example response

{
  "status": "success",
  "data": {
    "status": "success",
    "data": {
      "contacts": [
        {
          "lid": "169724423991411@lid",
          "pn": "491729682587@c.us"
        }
      ],
      "count": 1
    }
  },
  "links": {
    "self": "https://waapi.app/api/v1/instances/1/client/action/get-lid"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.