Scoring Lookup

Number scoring

post

Introduction

The number score api provides insight into how credible the number is. Get more information by reading our one-pager.

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 [email protected]

3

Out of balance

Contact [email protected]

4

Throttled

You are sending at higher rate per second than allocated. Contact [email protected]

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 [email protected]

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
post
/lookup/number-scoring
POST /lookup/number-scoring 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"
      }
    }
  }
]
PreviousPortability LookupNextGuidelines