# 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":""}}]}}}} ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://api.bind.hr/number-intelligence/scoring-lookup.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.