# Scoring Lookup ## Number scoring > \*\*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 | :airplane: |\ > \| 1 | General error | Repeating the request won't yield different result |\ > \| 2 | Pricing not set | Contact \[]\(mailto:) |\ > \| 3 | Out of balance | Contact \[]\(mailto:) |\ > \| 4 | Throttled | You are sending at higher rate per second than allocated. Contact \[]\(mailto:) |\ > \| 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 \[]\(mailto:) |\ > \ > \*\*\*\ > \ > \### \`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\` ```json {"openapi":"3.1.0","info":{"title":"Number intelligence API","version":"1.0"},"servers":[{"url":"https://number-api.bind.hr"}],"security":[{"default":[]}],"components":{"securitySchemes":{"default":{"type":"apiKey","in":"header","name":"X-API-KEY"}},"schemas":{"MsisdnRequest":{"type":"object","required":["msisdn"],"properties":{"msisdn":{"type":"array","items":{"type":"string"},"description":"A list of MSISDNs to look up."},"callback_url":{"type":"string","format":"uri","description":"An optional URL to receive a callback with the results."}}}}},"paths":{"/lookup/number-scoring":{"post":{"summary":"Number scoring","description":"**Introduction**\n\nThe number score api provides insight into how credible the number is.\nGet more information by reading our [one-pager.](https://www.bind.hr/docs/bind-one-pager-number-intelligence.pdf)\n\n### `date`\n\n**Type:** `string` (ISO 8601 timestamp)\n**Example:** `2025-06-21T17:21:56.526Z`\n**Description:** The exact date and time when this record was generated or last updated.\n\n***\n\n### `msisdn`\n\n**Type:** `string`\n**Format:** Country code + subscriber number (no separators)\n**Example:** `38591XXXXXXX`\n**Description:** Mobile Station International Subscriber Directory Number – the full telephone number including country code.\n\n***\n\n### `phone`\n\nAn object containing detailed telecom metadata about the number.\n\n| Field | Type | Example | Description |\n| :---- | :--- | :------ | :---------- |\n| `country_calling_code` | `string` | `385` | International dialing code for the country. |\n| `country_name` | `string` | `Croatia` | Official country name. |\n| `current_network_mobile_code` | `string` | `01` | Mobile network code (MNC) of the network the number is currently registered on. |\n| `first_seen` | `string` | `2017-03-05` | Date the number was first observed in our system. |\n| `current_network_name` | `string` | `T-Mobile` | Human-readable name of the network the number currently uses. |\n| `initial_network_name` | `string` | `A1` | Name of the network where the number was first issued. |\n| `initial_network_mobile_code` | `string` | `10` | Mobile network code (MNC) of the initial network. |\n| `first_ported` | `string` | `2017-03-05` | Date the number was first ported from its original network. |\n| `last_ported` | `string` | `2024-02-06` | Date the number was most recently ported to a different network. |\n| `mobile_country_code` | `string` | `219` | Mobile Country Code (MCC) assigned to the country/operator. |\n| `ported_times` | `integer` | `4` | Total number of times the number has been ported between networks. |\n| `type` | `string` | `mobile` | Phone type; e.g. `landline`, `mobile`, `toll_free`, `shared_cost`, `voip`, `emergency`, `n/a`. |\n\n### `response`\n\n| Value | Description | Action |\n| :---- | :------------------ | :------------------------------------------------------------------------------------------------------------------ |\n| 0 | Success | :airplane: |\n| 1 | General error | Repeating the request won't yield different result |\n| 2 | Pricing not set | Contact [procurement@bind.hr](mailto:procurement@bind.hr) |\n| 3 | Out of balance | Contact [procurement@bind.hr](mailto:procurement@bind.hr) |\n| 4 | Throttled | You are sending at higher rate per second than allocated. Contact [procurement@bind.hr](mailto:procurement@bind.hr) |\n| 5 | Invalid number | Number length not valid |\n| 6 | Not resolved | Number cannot be resolved due to missing coverage |\n| 7 | Timeout | Number cannot be resolved due to timeout |\n| 8 | Missing permissions | Contact [procurement@bind.hr](mailto:procurement@bind.hr) |\n\n***\n\n### `scoring`\n\nAn object describing quality or trust metrics for the number.\n\n| Field | Type | Example | Description |\n| :------------ | :------- | :------ | :---------------------------------------------------------- |\n| `credibility` | `string` | `high` | Values: `very_low`, `low`, `intermediate`, `high`, `very_high` |\n\nThe higher the credibility the more the number is a credible / trusted number.\n\n***\n\n### `security`\n\nAn object detailing any security-related flags or breach history.\n\n| Field | Type | Example | Description |\n| :--------------------------- | :-------- | :----------- | :--------------------------------------------------------------------------------------- |\n| `data_breaches_count` | `integer` | `3` | Number of known data breaches involving this number or associated account. |\n| `data_breaches_first_breach` | `string` | `2018-10-16` | Date of the earliest recorded breach. |\n| `data_breaches_last_breach` | `string` | `2021-04-08` | Date of the most recent recorded breach. |\n| `is_disposable` | `string` | `no` | Indicates whether the number is from a disposable/temporary service (`yes`/`no` / `n/a`) |\n\n### `social_presence`\n\nAn object mapping major platforms to presence indicators.\n\n- **`has`** may be:\n - `yes` – profile found\n - `no` – profile explicitly not found\n - `n/a` – lookup wasn’t possible (information unavailable)\n- **`is_business`** (where applicable): `yes`/`no`","operationId":"get_lookupnumber-score","tags":["Scoring Lookup"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MsisdnRequest"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["date","msisdn","response"],"properties":{"date":{"type":"string"},"msisdn":{"type":"string"},"response":{"type":"integer"},"phone":{"type":"object","properties":{"country_calling_code":{"type":"string"},"country_name":{"type":"string"},"current_network_mobile_code":{"type":"string"},"current_network_name":{"type":"string"},"first_ported":{"type":"string"},"first_seen":{"type":"string"},"initial_network_name":{"type":"string"},"initial_network_mobile_code":{"type":"string"},"last_ported":{"type":"string"},"mobile_country_code":{"type":"string"},"ported_times":{"type":"integer"},"type":{"type":"string"}}},"scoring":{"type":"object","properties":{"credibility":{"type":"string"}}},"security":{"type":"object","properties":{"data_breaches_count":{"type":"integer"},"data_breaches_first_breach":{"type":"string"},"data_breaches_last_breach":{"type":"string"},"is_disposable":{"type":"string"}}},"social_presence":{"type":"object","properties":{"amazon":{"type":"object","properties":{"has":{"type":"string"}}},"apple":{"type":"object","properties":{"has":{"type":"string"}}},"bukalapak":{"type":"object","properties":{"has":{"type":"string"}}},"facebook":{"type":"object","properties":{"has":{"type":"string"}}},"flipkart":{"type":"object","properties":{"has":{"type":"string"}}},"google":{"type":"object","properties":{"has":{"type":"string"}}},"instagram":{"type":"object","properties":{"has":{"type":"string"}}},"linkedin":{"type":"object","properties":{"has":{"type":"string"}}},"snapchat":{"type":"object","properties":{"has":{"type":"string"}}},"telegram":{"type":"object","properties":{"has":{"type":"string"}}},"viber":{"type":"object","properties":{"has":{"type":"string"}}},"whatsapp":{"type":"object","properties":{"has":{"type":"string"},"is_business":{"type":"string"}}},"x":{"type":"object","properties":{"has":{"type":"string"}}}}}}}}}}},"401":{"description":"Unauthorized","content":{"text/plain":{}}}},"parameters":[{"name":"X-API-KEY","in":"header","required":true,"description":"API key","schema":{"type":"string","format":"password","default":""}}]}}}} ```