Contacts

Network Lookup

Look up a destination number to check its validity, line type, and network carrier. Use this before sending SMS to avoid dispatching to invalid or inactive numbers.

POST

/v1/contacts/lookup

Authorization

Header

X-Emisri-Api-Key: your_secret_key

Required

yes

Request body

application/json

Field	Type	Required	Description
destination	string	yes	The destination number to look up, in international format without the + sign (e.g. 2348012345678).

Response · 200 OK

application/json

Field	Type	Required	Description
success	boolean	—	true when the lookup completed successfully.
message	string	—	Human-readable summary of the lookup result.
data	object	—	The response payload.

Request Samples

Request

const response = await fetch('https://BASE_URL/v1/contacts/lookup', {
  method: 'POST',
  headers: {
    'X-Emisri-Api-Key': 'your_secret_key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    destination: '234812345689',
  }),
})
const data = await response.json()

Response Samples

Response · 200 OK

{
  "success": true,
  "message": "Lookup completed successfully.",
  "data": {
    "id": "20260709185626-E0C6C9322E3B1000",
    "number": "234812345689",
    "country": {
      "name": "Nigeria",
      "callingCode": "234",
      "iso": "NG",
      "mcc": "621",
      "region": "Lagos",
      "timeZone": "Africa/Lagos"
    },
    "operator": {
      "name": "MTN Nigeria",
      "code": "MTN",
      "mnc": "30",
      "routingCode": "31",
      "carrierId": "23430",
      "lineType": "Mobile",
      "ported": false
    },
    "communication": {
      "voice": true,
      "sms": true,
      "whatsapp": false,
      "rcs": false,
      "dndEnabled": false
    },
    "fraudRisk": {
      "fraudScore": 0,
      "riskLevel": "No Risk",
      "blacklisted": false,
      "simSwap": false,
      "spamReports": 0
    },
    "identityEnrichment": {
      "businessName": null,
      "businessType": null,
      "linkedin": null
    },
    "contact": {
      "exists": true,
      "displayName": "John Doe",
      "dateAdded": "10 Mar 2026"
    }
  }
}