> For the complete documentation index, see [llms.txt](https://api.bind.hr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api.bind.hr/number-intelligence/one-lookup.md). # One Lookup ## OneLookup > \*\*Introduction\*\*\ > \ > OneLookup is a single endpoint that combines a real-time (HLR) query with a database fallback, letting you validate one or many numbers in a single call.\ > \ > For each MSISDN you submit it returns the number's country and network information, portability status and — when a live query succeeds — its real-time availability via a GSM error code.\ > \ > Each response contains:\ > \ > \- \`date\` — time when the request was executed (ISO8601)\ > \- \`msisdn\` — the number for which the response has been returned\ > \- \`live\` — whether the result was obtained from a live (real-time) query\ > \- \`numberType\` — the type of number (e.g. \`Mobile\`)\ > \- \`mcc\` — Mobile country code (\[learn more]\( > \- \`mnc\` — Mobile network code the number currently belongs to\ > \- \`omnc\` — Original network code (the network the number originally belonged to)\ > \- \`spid\` — Service provider ID of the current network\ > \- \`oSpid\` — Service provider ID of the original network\ > \- \`imsi\` — IMSI (\[learn more]\()); returned when available\ > \- \`originalNetwork\` (the network to which the number originally belonged)\ > \- \`countryName\`\ > \- \`countryPrefix\`\ > \- \`networkName\`\ > \- \`portedNetwork\` (the network to which the number is currently ported); returned when \`ported\` is \`true\`\ > \- \`countryName\`\ > \- \`countryPrefix\`\ > \- \`networkName\`\ > \- \`ported\` — denotes whether the number has been ported\ > \- \`gsmErrorCode\` — error code related to user availability (see below)\ > \- \`price\` — the price for this request\ > \- \`response\` — the result code (see below)\ > \ > \*\*Response values\*\*\ > \ > \| Value | Description | Action |\ > \|------:|-------------|--------|\ > \| 0 | Success | ✈️ |\ > \| 1 | General error | Repeating the request won't yield a different result |\ > \| 2 | Pricing not set | Contact |\ > \| 3 | Out of balance | Contact |\ > \| 4 | Throttled | Contact |\ > \| 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 |\ > \ > \*\*GSM error codes\*\*\ > \ > \| EC | ERROR DESCRIPTION |\ > \| --- | --------------------------------- |\ > \| 0 | REACHABLE |\ > \| 1 | UNKNOWN\_SUBSCRIBER |\ > \| 5 | UNIDENTIFIED\_SUBSCRIBER |\ > \| 9 | ILLEGAL\_SUBSCRIBER |\ > \| 11 | TELESERVICE\_NOT\_PROVISIONED |\ > \| 13 | CALL\_BARRED |\ > \| 21 | FACILITY\_NOT\_SUPPORTED |\ > \| 27 | ABSENT\_SUBSCRIBER |\ > \| 31 | SUBSCRIBER\_BUSY\_FOR\_MT\_SMS |\ > \| 32 | DELIVERY\_FAILURE |\ > \| 34 | SYSTEM\_FAILURE |\ > \| 36 | UNEXPECTED\_DATA\_VALUE |\ > \| 37 | MEMORY\_CAPACITY\_EXCEEDED |\ > \| 38 | PREFIX\_NOT\_RESOLVED |\ > \| 39 | IMSI\_BLACKLISTED |\ > \| 40 | DEST\_ADDRESS\_BLACKLISTED |\ > \| 41 | TIME\_OUT |\ > \| 43 | INVALID\_ORIGINATOR\_ADDRESS |\ > \| 100 | GENERAL\_ERROR |\ > \| 200 | EQUIPMENT\_PROTOCOL\_ERROR |\ > \| 201 | UNKNOWN\_MSC |\ > \| 202 | CONGESTION\_ERROR |\ > \| 203 | PARAMETER\_MISSMATCH |\ > \| 204 | INITIATING\_RELEASE |\ > \| 205 | POTENTIAL\_VERSION\_INCOMPATIBILITY |\ > \| 206 | REMOTE\_NODE\_NOT\_REACHABLE |\ > \| 207 | MTP\_FAILURE |\ > \| 208 | NETWORK\_CONGESTION |\ > \| 209 | SIGNALLING\_FAILURE |\ > \| 210 | ABNORMAL\_MAP\_DIALOG |\ > \| 211 | INVALID\_PDU\_FORMAT |\ > \| 300 | ABORTED\_RETRY |\ > \| 301 | VALIDITY\_PERIOD\_EXPIRED | ```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/onelookup":{"post":{"summary":"OneLookup","description":"**Introduction**\n\nOneLookup is a single endpoint that combines a real-time (HLR) query with a database fallback, letting you validate one or many numbers in a single call.\n\nFor each MSISDN you submit it returns the number's country and network information, portability status and — when a live query succeeds — its real-time availability via a GSM error code.\n\nEach response contains:\n\n- `date` — time when the request was executed (ISO8601)\n- `msisdn` — the number for which the response has been returned\n- `live` — whether the result was obtained from a live (real-time) query\n- `numberType` — the type of number (e.g. `Mobile`)\n- `mcc` — Mobile country code ([learn more](https://en.wikipedia.org/wiki/Mobile_country_code))\n- `mnc` — Mobile network code the number currently belongs to\n- `omnc` — Original network code (the network the number originally belonged to)\n- `spid` — Service provider ID of the current network\n- `oSpid` — Service provider ID of the original network\n- `imsi` — IMSI ([learn more](https://en.wikipedia.org/wiki/International_mobile_subscriber_identity)); returned when available\n- `originalNetwork` (the network to which the number originally belonged)\n - `countryName`\n - `countryPrefix`\n - `networkName`\n- `portedNetwork` (the network to which the number is currently ported); returned when `ported` is `true`\n - `countryName`\n - `countryPrefix`\n - `networkName`\n- `ported` — denotes whether the number has been ported\n- `gsmErrorCode` — error code related to user availability (see below)\n- `price` — the price for this request\n- `response` — the result code (see below)\n\n**Response values**\n\n| Value | Description | Action |\n|------:|-------------|--------|\n| 0 | Success | ✈️ |\n| 1 | General error | Repeating the request won't yield a different result |\n| 2 | Pricing not set | Contact procurement@bind.hr |\n| 3 | Out of balance | Contact procurement@bind.hr |\n| 4 | Throttled | Contact 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 |\n\n**GSM error codes**\n\n| EC | ERROR DESCRIPTION |\n| --- | --------------------------------- |\n| 0 | REACHABLE |\n| 1 | UNKNOWN_SUBSCRIBER |\n| 5 | UNIDENTIFIED_SUBSCRIBER |\n| 9 | ILLEGAL_SUBSCRIBER |\n| 11 | TELESERVICE_NOT_PROVISIONED |\n| 13 | CALL_BARRED |\n| 21 | FACILITY_NOT_SUPPORTED |\n| 27 | ABSENT_SUBSCRIBER |\n| 31 | SUBSCRIBER_BUSY_FOR_MT_SMS |\n| 32 | DELIVERY_FAILURE |\n| 34 | SYSTEM_FAILURE |\n| 36 | UNEXPECTED_DATA_VALUE |\n| 37 | MEMORY_CAPACITY_EXCEEDED |\n| 38 | PREFIX_NOT_RESOLVED |\n| 39 | IMSI_BLACKLISTED |\n| 40 | DEST_ADDRESS_BLACKLISTED |\n| 41 | TIME_OUT |\n| 43 | INVALID_ORIGINATOR_ADDRESS |\n| 100 | GENERAL_ERROR |\n| 200 | EQUIPMENT_PROTOCOL_ERROR |\n| 201 | UNKNOWN_MSC |\n| 202 | CONGESTION_ERROR |\n| 203 | PARAMETER_MISSMATCH |\n| 204 | INITIATING_RELEASE |\n| 205 | POTENTIAL_VERSION_INCOMPATIBILITY |\n| 206 | REMOTE_NODE_NOT_REACHABLE |\n| 207 | MTP_FAILURE |\n| 208 | NETWORK_CONGESTION |\n| 209 | SIGNALLING_FAILURE |\n| 210 | ABNORMAL_MAP_DIALOG |\n| 211 | INVALID_PDU_FORMAT |\n| 300 | ABORTED_RETRY |\n| 301 | VALIDITY_PERIOD_EXPIRED |","operationId":"one-lookup","tags":["OneLookup"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MsisdnRequest"}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["date","msisdn","price","response"],"properties":{"date":{"type":"string"},"msisdn":{"type":"string"},"live":{"type":"boolean"},"numberType":{"type":"string"},"mcc":{"type":"string"},"mnc":{"type":"string"},"omnc":{"type":"string"},"spid":{"type":"integer"},"oSpid":{"type":"integer"},"imsi":{"type":"string"},"originalNetwork":{"type":"object","properties":{"countryName":{"type":"string"},"countryPrefix":{"type":"string"},"networkName":{"type":"string"}}},"portedNetwork":{"type":"object","properties":{"countryName":{"type":"string"},"countryPrefix":{"type":"string"},"networkName":{"type":"string"}}},"ported":{"type":"boolean"},"gsmErrorCode":{"type":"integer"},"price":{"type":"number"},"response":{"type":"integer"}}}}}}},"401":{"description":"401","content":{"text/plain":{}}},"500":{"description":"500","content":{"text/plain":{}}}},"deprecated":false}}}} ```