Global - Phone Lookup

API Reference

Endpoint

https://api.verifik.co/v2/look-ups/phone

The Phone Lookup service resolves a worldwide mobile or landline number to the listed owner name and related profile fields when the source has a match. Send countryCode (numeric calling code) and phone (national number, no country prefix) via GET (query) or POST (JSON body). A successful data object includes name, phone, countryCode, and may include score, gender, about, jobTitle, companyName, phones, addresses, internetAddresses, imId, access, and enhanced. Use it for onboarding, fraud screening, and contact verification — not for OTP ownership proof.

To send an SMS or WhatsApp one-time code instead, see Phone Validations.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Parameters

Name	Type	Required	Description
countryCode	string	Yes	Numeric calling code, not ISO2. Example: 57 for Colombia, 1 for the United States.
phone	string	Yes	National number of the line to look up, without the country prefix, spaces, or punctuation.

Request

JavaScript

import axios from "axios";

const options = {
  method: "GET",
  url: "https://api.verifik.co/v2/look-ups/phone",
  params: { countryCode: "57", phone: "3006094511" },
  headers: {
    Accept: "application/json",
    Authorization: "Bearer <your_token>",
  },
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Python

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")
payload = ""
headers = {}
conn.request("GET", "/v2/look-ups/phone?countryCode=57&phone=3006094511", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Response

200

{
  "data": {
    "about": "",
    "access": "",
    "addresses": [],
    "companyName": {},
    "countryCode": "57",
    "enhanced": "",
    "gender": "",
    "imId": "",
    "internetAddresses": [],
    "jobTitle": "",
    "name": "JANE DOE",
    "phone": "3006094511",
    "phones": [],
    "score": 0.9
  },
  "signature": {
    "dateTime": "March 13, 2024 10:48 PM",
    "message": "Certified by Verifik.co"
  }
}

404

{
  "code": "NotFound",
  "message": "Record not found."
}

409 (Missing Parameters)

{
  "code": "MissingParameter",
  "message": "countryCode|phone is missing"
}

409 (Upstream Unavailable)

{
  "code": "Conflict",
  "message": "Endpoint out of service."
}

Notes

• GET and POST are both supported. POST accepts the same fields in a JSON body.
• countryCode is the numeric calling code (for example 57), not an ISO2 country code such as CO.
• Send phone as the national number only — do not prefix the country code again.
• Profile fields beyond name, phone, and countryCode are optional; the source may omit them.
• There are no sandbox fixtures for this route. Lookups hit the live source. Temporary outages return 409 with Endpoint out of service.
• A 404 means no listing was found (or the calling code is unknown). Paying clients are not charged for 404s.
• This endpoint does not prove the caller owns the handset. For OTP verification, use Phone Validations.