Contact Verification

Contact verification

post

Introduction

The contact verification api provides insight into how credible the number is.

date

Type: string (ISO 8601 timestamp) Example: 2025-06-21T17:21:56.526Z Description: The exact date and time when this record was generated or last updated.

---

msisdn

Type: string Format: Country code + subscriber number (no separators) Example: 38591XXXXXXX Description: Mobile Station International Subscriber Directory Number – the full telephone number including country code.

---

phone

An object containing detailed telecom metadata about the number.

Field	Type	Example	Description
country_calling_code	string	385	International dialing code for the country.
country_name	string	Croatia	Official country name.
current_network_mobile_code	string	01	Mobile network code (MNC) of the network the number is currently registered on.
first_seen	string	2017-03-05	Date the number was first observed in our system.
current_network_name	string	T-Mobile	Human-readable name of the network the number currently uses.
initial_network_name	string	A1	Name of the network where the number was first issued.
initial_network_mobile_code	string	10	Mobile network code (MNC) of the initial network.
first_ported	string	2017-03-05	Date the number was first ported from its original network.
last_ported	string	2024-02-06	Date the number was most recently ported to a different network.
mobile_country_code	string	219	Mobile Country Code (MCC) assigned to the country/operator.
ported_times	integer	4	Total number of times the number has been ported between networks.
type	string	mobile	Phone type; e.g. landline, mobile, toll_free, shared_cost, voip, emergency, n/a.

response

Value	Description	Action
0	Success	✈️
1	General error	Repeating the request won't yield different result
2	Pricing not set	Contact [e-mail]
3	Out of balance	Contact [e-mail]
4	Throttled	You are sending at higher rate per second than allocated. Contact [e-mail]
5	Invalid number	Number length not valid
6	Not resolved	Number cannot be resolved due to missing coverage
7	Timeout	Number cannot be resolved due to timeout
8	Missing permissions	Contact [e-mail]

---

scoring

An object describing quality or trust metrics for the number.

Field	Type	Example	Description
credibility	string	high	Values: very_low, low, intermediate, high, very_high

The higher the credibility the more the number is a credible / trusted number.

---

security

An object detailing any security-related flags or breach history.

Field	Type	Example	Description
data_breaches_count	integer	3	Number of known data breaches involving this number or associated account.
data_breaches_first_breach	string	2018-10-16	Date of the earliest recorded breach.
data_breaches_last_breach	string	2021-04-08	Date of the most recent recorded breach.
is_disposable	string	no	Indicates whether the number is from a disposable/temporary service (yes/no / n/a)

social_presence

An object mapping major platforms to presence indicators.

• has may be:

  • yes – profile found

  • no – profile explicitly not found

  • n/a – lookup wasn’t possible (information unavailable)

• is_business (where applicable): yes/no

Authorizations

X-API-KEYstringRequired

Header parameters

X-API-KEYstring · passwordRequired

API key

Default: ""

Body

msisdnstring[]Required

A list of MSISDNs to look up.

callback_urlstring · uriOptional

An optional URL to receive a callback with the results.

Responses

200Success

application/json

datestringRequiredExample: 2025-09-01T09:06:46.285Z

msisdnstringRequiredExample: 4473481234567

responseintegerRequiredExample: 0

401

Unauthorized

text/plain

post/lookup/contact-verification

POST /lookup/contact-verification HTTP/1.1
Host: number-api.bind.hr
X-API-KEY: 
Content-Type: application/json
Accept: */*
Content-Length: 28

{
  "msisdn": [
    "4473481234567"
  ]
}

[
  {
    "date": "2025-09-01T09:06:46.285Z",
    "msisdn": "4473481234567",
    "phone": {
      "country_calling_code": "44",
      "country_name": "United Kingdom",
      "current_network_mobile_code": "33",
      "current_network_name": "EE",
      "first_ported": "2017-03-05",
      "first_seen": "2017-03-05",
      "initial_network_name": "Vodafone UK",
      "initial_network_mobile_code": "15",
      "last_ported": "2024-02-06",
      "mobile_country_code": "234",
      "ported_times": 4,
      "type": "mobile"
    },
    "response": 0,
    "scoring": {
      "credibility": "high"
    },
    "security": {
      "data_breaches_count": 3,
      "data_breaches_first_breach": "2018-10-16",
      "data_breaches_last_breach": "2021-04-08",
      "is_disposable": "no"
    },
    "social_presence": {
      "amazon": {
        "has": "yes"
      },
      "apple": {
        "has": "yes"
      },
      "bukalapak": {
        "has": "n/a"
      },
      "facebook": {
        "has": "yes"
      },
      "flipkart": {
        "has": "n/a"
      },
      "google": {
        "has": "n/a"
      },
      "instagram": {
        "has": "no"
      },
      "linkedin": {
        "has": "n/a"
      },
      "snapchat": {
        "has": "n/a"
      },
      "telegram": {
        "has": "yes"
      },
      "viber": {
        "has": "n/a"
      },
      "whatsapp": {
        "has": "yes",
        "is_business": "no"
      },
      "x": {
        "has": "yes"
      }
    }
  }
]