{"_id":"55154597f854a3190036872d","category":{"_id":"55154749c28d6125001b8885","__v":3,"pages":["551abac26491a10d0099943c","551ba163944d6b2f00479d47","551bc170c08a24210029d50e"],"project":"54eb50e5615ffc1900305a16","version":"54eb63b859b1172100334fae","sync":{"url":"","isSync":false},"reference":true,"createdAt":"2015-03-27T12:04:25.647Z","from_sync":false,"order":9,"slug":"number-context","title":"Number Lookup"},"user":"54eb4fdedf7add210007b29b","__v":12,"parentDoc":null,"project":"54eb50e5615ffc1900305a16","version":{"_id":"54eb63b859b1172100334fae","project":"54eb50e5615ffc1900305a16","forked_from":"54eb63a1867e1917009b711d","__v":27,"createdAt":"2015-02-23T17:30:32.501Z","releaseDate":"2015-02-23T17:30:32.501Z","categories":["54eb63b959b1172100334faf","54eb63b959b1172100334fb0","54eb63b959b1172100334fb1","54eb63b959b1172100334fb2","54ed8dd4ab373e2300f50eae","54ed99b2ab373e2300f50ede","55153a6de68daa2f00cff838","551546edbc466623002afe72","5515472ac28d6125001b8884","55154749c28d6125001b8885","555d9b4106dfec0d00d38ea7","5613e06e433e5735007c7708","5624bbb785a31117001c5403","56669e857cc81e0d00253f8e","568b8d837a42220d00498311","56a632277ef6620d00e2f18a","56d8147c3eb4dd0b00201aac","57a9ce2fac6db30e000d7efd","57a9cf4e944ea60e00dc3f74","58172386715dce0f00da4aa0","582dc59ee1b8692300c0dd03","589b19b4fec2730f0082e040","58b04a023529383900a759b5","58b92d1598157a0f004869bf","592e7685c58275000f20174f","59392839e376d4002f8a0474","59393064e376d4002f8a05a1","5947ae0d4005e2000f3a4fec","594a74df1d1de5001ab3517a","5954bc387a147f001b918915"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-03-27T11:57:11.305Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":true,"order":0,"body":"Number Lookup helps you keep your mobile numbers database up to date.\n\nMobile subscribers often change numbers, go into roaming and change providers while retaining their original phone number. Knowing which mobile numbers are in use and available, or which network your client is currently using can greatly improve accuracy and cost effectiveness for many types of businesses.\n\nWith Number Lookup, you can determine:\n\n - which numbers are currently active\n - is the mobile number in roaming\n - is the mobile number ported\n - the optimal route for messages and voice\n\nVarious **Number Lookup packages** are available, so you can choose the one that best fits your business:\n\n- **Database Cleaning:** Designed for companies with vast number databases, our Database Cleaning package enables identifying unused and inactive numbers.\n\n- **Portability:** Developed to resolve number portability issues for various company types, this package enables real-time number portability lookups to optimize message and voice routing. It includes all the features of the Database Cleaning package.\n\n- **Roaming:** Primarily created to serve the financial client segment, the package provides roaming information for optimized routing, prevention of ATM frauds and much more.\n\nThe following example shows how you can get Number Lookup information using our API:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"POST /number/1/query HTTP/1.1\\nHost: api.infobip.com\\nAuthorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=\\nContent-Type: application/json\\nAccept: application/json\\n\\n{  \\n   \\\"to\\\":[\\\"41793026727\\\"]\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\nThe `to` parameter is a list of all the numbers you want to check. \n\nHere is your result:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"HTTP/1.1 200 OK\\nContent-Type: application/json\\n\\n{  \\n   \\\"results\\\":[  \\n      {  \\n         \\\"to\\\":\\\"41793026727\\\",\\n         \\\"mccMnc\\\":\\\"22801\\\",\\n         \\\"imsi\\\":\\\"228012120181810\\\",\\n         \\\"originalNetwork\\\":{  \\n            \\\"networkPrefix\\\":\\\"79\\\",\\n            \\\"countryPrefix\\\":\\\"41\\\"\\n         },\\n         \\\"ported\\\":false,\\n         \\\"roaming\\\":false,\\n         \\\"status\\\":{  \\n            \\\"groupId\\\":3,\\n            \\\"groupName\\\":\\\"DELIVERED\\\",\\n            \\\"id\\\":5,\\n            \\\"name\\\":\\\"DELIVERED_TO_HANDSET\\\",\\n            \\\"description\\\":\\\"Message delivered to handset\\\"\\n         },\\n         \\\"error\\\":{  \\n            \\\"groupId\\\":0,\\n            \\\"groupName\\\":\\\"OK\\\",\\n            \\\"id\\\":0,\\n            \\\"name\\\":\\\"NO_ERROR\\\",\\n            \\\"description\\\":\\\"No Error\\\",\\n            \\\"permanent\\\":false\\n         }\\n      }\\n   ]\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Information:\",\n  \"body\": \"Depending on your package, some information may not be accessible. For a package change, contact your Account Manager.\"\n}\n[/block]\n----------\nFor more information about this method and receiving a Number Lookup result on your Notify URL, visit the official documentation [page](doc:sending-synchronous-request).","excerpt":"The API which ensures mobile number validity!","slug":"number-context","type":"basic","title":"Number Lookup introduction"}

Number Lookup introduction

The API which ensures mobile number validity!

Number Lookup helps you keep your mobile numbers database up to date. Mobile subscribers often change numbers, go into roaming and change providers while retaining their original phone number. Knowing which mobile numbers are in use and available, or which network your client is currently using can greatly improve accuracy and cost effectiveness for many types of businesses. With Number Lookup, you can determine: - which numbers are currently active - is the mobile number in roaming - is the mobile number ported - the optimal route for messages and voice Various **Number Lookup packages** are available, so you can choose the one that best fits your business: - **Database Cleaning:** Designed for companies with vast number databases, our Database Cleaning package enables identifying unused and inactive numbers. - **Portability:** Developed to resolve number portability issues for various company types, this package enables real-time number portability lookups to optimize message and voice routing. It includes all the features of the Database Cleaning package. - **Roaming:** Primarily created to serve the financial client segment, the package provides roaming information for optimized routing, prevention of ATM frauds and much more. The following example shows how you can get Number Lookup information using our API: [block:code] { "codes": [ { "code": "POST /number/1/query HTTP/1.1\nHost: api.infobip.com\nAuthorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=\nContent-Type: application/json\nAccept: application/json\n\n{ \n \"to\":[\"41793026727\"]\n}", "language": "json" } ] } [/block] The `to` parameter is a list of all the numbers you want to check. Here is your result: [block:code] { "codes": [ { "code": "HTTP/1.1 200 OK\nContent-Type: application/json\n\n{ \n \"results\":[ \n { \n \"to\":\"41793026727\",\n \"mccMnc\":\"22801\",\n \"imsi\":\"228012120181810\",\n \"originalNetwork\":{ \n \"networkPrefix\":\"79\",\n \"countryPrefix\":\"41\"\n },\n \"ported\":false,\n \"roaming\":false,\n \"status\":{ \n \"groupId\":3,\n \"groupName\":\"DELIVERED\",\n \"id\":5,\n \"name\":\"DELIVERED_TO_HANDSET\",\n \"description\":\"Message delivered to handset\"\n },\n \"error\":{ \n \"groupId\":0,\n \"groupName\":\"OK\",\n \"id\":0,\n \"name\":\"NO_ERROR\",\n \"description\":\"No Error\",\n \"permanent\":false\n }\n }\n ]\n}", "language": "json" } ] } [/block] [block:callout] { "type": "info", "title": "Information:", "body": "Depending on your package, some information may not be accessible. For a package change, contact your Account Manager." } [/block] ---------- For more information about this method and receiving a Number Lookup result on your Notify URL, visit the official documentation [page](doc:sending-synchronous-request).