Number Scoring

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

Example response

[
  {
    "date": "2025-06-21T17:21:56.526Z",
    "msisdn": "38591XXXXXXX",
    "phone": {
      "country_calling_code": "385",
      "country_name": "Croatia",
      "current_network_mobile_code": "01",
      "current_network_name": "T-Mobile",
      "first_ported": "2017-03-05",
      "first_seen": "2017-03-05",
      "initial_network_name": "A1",
      "initial_network_mobile_code": "10",
      "last_ported": "2024-02-06",
      "mobile_country_code": "219",
      "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"
      }
    }
  }
]

`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. landlinemobile toll_freeshared_cost voip mobile 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