\nREST API<\/strong>
\n<\/b> (Application Programming Interface Representational State Transfer) is a form of communication between systems using HTTP conventions. Imagine it is a messenger that carries requests and responses between your application and a server. REST APIs are widely used due to their simplicity and efficiency.<\/p>\n
Main components of a REST API<\/h3>\n\n
\nResources<\/strong>
\n<\/b>They represent data, such as users or products.<\/li>\n
\nHTTP Verbs<\/strong>
\n<\/b>Methods such as GET, POST, PUT and DELETE to interact with resources.<\/li>\n
\nEndpoints<\/strong>
\n<\/b>URLs indicating where a specific resource is located.<\/li>\n
\nData Format<\/strong>
\n<\/b>Usually JSON or XML.<\/li>\n<\/ol>\nPractical Example: Phone Number Verification with HLR Lookup<\/h3>\n
Phone number verification using
\nHLR Lookup<\/strong>
\n<\/b>(Home Location Register Lookup<\/a>) allows you to know if a number is valid and active. This is useful for companies that want to ensure that their messages reach the right recipients.<\/p>\nVerification process<\/h4>\n\n
\nYou send a request<\/strong>
\n<\/b> with the phone number to the HLR Lookup API.<\/li>\n
\nThe validation API queries<\/strong>
\n<\/b> the HLR database of the telephone operator.<\/li>\n
\nYou receive a response<\/strong>
\n<\/b> indicating the status of the phone number.<\/li>\n<\/ol>\nStep-by-step implementation using the verificaremails.com API<\/h4>\n\n- Register<\/strong>
\n<\/b> at verificaremails.com<\/a> and get your API key.<\/li>\n- Sends a GET request<\/strong>
\n<\/b> request to the HLR Lookup validation API.<\/li>\n<\/ol>\ncurl -X GET \"https:\/\/www.verificaremails.com\/api\/v1\/hlr?phone_number=1234567890\" \r\n-H \"apikey: TU_CLAVE_API\"<\/pre>\n\n
\nInterpret the answer<\/strong>
\n<\/b>. An example of a response might be:<\/li>\n<\/ol>\n{\r\n\"status\": \"success\",\r\n\"data\": {\r\n\"phone_number\": \"1234567890\",\r\n\"valid\": true,\r\n\"carrier\": \"Movistar\",\r\n\"country\": \"ES\"\r\n}\r\n}<\/pre>\nWe can get more information about the phone number in particular if it is a mobile number in the JSON file of the response.<\/p>\n
Response format<\/strong><\/p>\nIf we go into detail, apart from indicating whether the number is valid or invalid, we can obtain information about the telephone operator, the type of line, the international format of the number… If you want to know if the number is valid you should look at the IMSI, MCC, MNC and MCCMNC fields. All these checks are performed by the validation api and displayed in the value of the “reachable” field.<\/p>\n
IMSI<\/h3>\n
The
\nIMSI<\/strong>
\n<\/b> (International Mobile Subscriber Identity) is a unique number associated with each mobile network user. This number is stored on the SIM card and is used by mobile networks to identify subscribers.<\/p>\nIMSI Components<\/h3>\n
The IMSI is composed of three parts:<\/p>\n
\n
\nMCC (Mobile Country Code)<\/strong>
\n<\/b>Three-digit code that identifies the subscriber’s country.<\/li>\n
\nMNC (Mobile Network Code)<\/strong>
\n<\/b>Two or three digit code that identifies the mobile network within that country.<\/li>\n
\nMSIN (Mobile Subscriber Identification Number)<\/strong>
\n<\/b>Unique number that identifies the subscriber within the mobile network.<\/li>\n<\/ol>\nMCC and MNC<\/h3>\n\n- MCC<\/strong>
\n<\/b>CQI: Each country has a unique CQI. For example, Spain has MCC 214.<\/li>\n- MNC<\/strong>
\n<\/b>The operators within a country have different MNCs. For example, in Spain, Movistar has MNC 07.<\/li>\n<\/ul>\nMCCMNC<\/h3>\n
The
\nMCCMNC<\/strong>
\n<\/b> is the combination of the MCC and the MNC. It is used to uniquely identify a mobile network in a country. For example, the MCCMNC for Movistar in Spain would be 21407.<\/p>\nPhone Number Verification<\/h3>\n
To verify if a phone number is true using the IMSI:<\/p>\n
\n- Obtaining the IMSI<\/strong>
\n<\/b>Extract the IMSI from the SIM card of the phone.<\/li>\n- Analyze the IMSI<\/strong>
\n<\/b>:<\/li>\n- \n
\n- Extract the MCC and MNC from the IMSI.<\/li>\n
- Verify that the MCC corresponds to the expected country.<\/li>\n
- Verify that the MNC corresponds to a valid operator in that country.<\/li>\n<\/ul>\n<\/li>\n
- Validation<\/strong>
\n<\/b>:<\/li>\n- \n
\n- Check that the MCCMNC exists and is valid.<\/li>\n
- Ensure that the MSIN is correct and active on the network.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n
Example<\/h3>\n
If you have an IMSI 214071234567890, you can break it down like this:<\/p>\n
\n- MCC<\/strong>
\n<\/b>: 214 (Spain)<\/li>\n- MNC<\/strong>
\n<\/b>: 07 (Movistar)<\/li>\n- MSIN<\/strong>
\n<\/b>: 1234567890 (Subscriber’s Unique Identifier)<\/li>\n<\/ul>\nBy verifying the MCC and MNC, you can confirm that the phone number belongs to a Movistar subscriber in Spain, which helps validate its authenticity.<\/p>\n
{<\/pre>\n“id”: “364215”,<\/p>\n
“term”: “34677934019”,<\/p>\n
“request_id”: “364215”,<\/p>\n
“result_code”: “101”,<\/p>\n
“result_type”: “Connected”,<\/p>\n
“result”: {<\/p>\n
“phone_number”: “+34677934019”,<\/p>\n
“number_type”: “mobile”,<\/p>\n
“timezone”: “Atlantic\/Canary”,<\/p>\n
“format”: {<\/p>\n
“e164”: “+34677934019”,<\/p>\n
“international”: “+34 677 93 40 19”,<\/p>\n
“national”: “677 93 40 19”,<\/p>\n
“rfc3966”: “tel:+34-677-93-40-19”<\/p>\n
},<\/p>\n
“is_ported”: true,<\/p>\n
“reachable”: “connected”,<\/p>\n
“processing_status”: “completed”,<\/p>\n
“imsi”: “214040000000000”,<\/p>\n
“current_network”: {<\/p>\n
“country_iso2”: “EN”,<\/p>\n
“country_prefix”: “34”,<\/p>\n
“country_name”: “Spain”,<\/p>\n
“mccmnc”: “21404”,<\/p>\n
“mcc”: “214”,<\/p>\n
“mnc”: “04”,<\/p>\n
“area”: “ES”,<\/p>\n
“network_name”: “Yoigo”.<\/p>\n
},<\/p>\n
“original_network”: {<\/p>\n
“country_iso2”: “EN”,<\/p>\n
“country_prefix”: “34”,<\/p>\n
“country_name”: “Spain”,<\/p>\n
“mccmnc”: “21401”,<\/p>\n
“mcc”: “214”,<\/p>\n
“mnc”: “01”,<\/p>\n
“area”: “ES”,<\/p>\n
“network_name”: “Vodafone”.<\/p>\n
}<\/p>\n
}<\/p>\n
}<\/p>\n
How to create a telephone number validator with PHP<\/h2>\n
To facilitate the use of the phone validator in your forms and applications, we have created a POSTMAN library<\/a> where you can download the api calls as well as code examples. In the case of our example, if we want to make a call in PHP, we must select this language within the Postman collection and the application itself will generate the PHP call to validate a phone number.<\/p>\n![\"validate](\"https:\/\/www.verificaremails.com\/wp-content\/uploads\/2024\/06\/Captura-de-pantalla-2024-06-19-184303.webp\")
<\/p>\n
Why validate phone numbers<\/h2>\n
Capturing leads is expensive and will become more so every day. It is estimated that between 8-12% of the telephones captured on forms or during registration processes are erroneous. Data verification at the point of capture allows these errors to be detected and registration rates to be improved.<\/p>\n
Once the lead is captured, it enters a “sales funnel” for its exploitation. If the phone number is wrong, we will be allocating resources that will never get a return. Our advice is to verify all phone numbers at the point of acquisition, but if you haven’t done so, at least verify the database to get a true picture of your potential customers.<\/p>\n
Conclusions<\/h2>\n
We have seen the different ways to validate phone numbers<\/a>. We have seen that this service is indicated for the verification of mobile numbers during the registration process, improving the quality of the data and avoiding the capture of invalid numbers. Remember that you can apply HLR Lookup validation<\/a> to individual phones, massively to files with a high volume of numbers or automating the process with the number validation API.<\/p>\nWe recommend that you review the validation API documentation<\/a> for the different phone<\/a> calls and if you want to have access to the validation libraries in the different programming languages. Although the API calls are Rest, it will always make it easier for you to integrate the service.<\/p>\n","protected":false},"excerpt":{"rendered":"In this article you will learn how to use the HLR Lookup API to validate phone numbers in real time. You will see how to perform individual validations, mass validations through files and how to automate the processes to create a number validator through the API. We will see several code examples, focusing on some … Read more<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[992],"tags":[],"class_list":["post-9457","post","type-post","status-publish","format-standard","hentry","category-verify-phones"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.verificaremails.com\/en\/wp-json\/wp\/v2\/posts\/9457","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.verificaremails.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.verificaremails.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.verificaremails.com\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.verificaremails.com\/en\/wp-json\/wp\/v2\/comments?post=9457"}],"version-history":[{"count":0,"href":"https:\/\/www.verificaremails.com\/en\/wp-json\/wp\/v2\/posts\/9457\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.verificaremails.com\/en\/wp-json\/wp\/v2\/media?parent=9457"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.verificaremails.com\/en\/wp-json\/wp\/v2\/categories?post=9457"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.verificaremails.com\/en\/wp-json\/wp\/v2\/tags?post=9457"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
\nResources<\/strong>
\n<\/b>They represent data, such as users or products.<\/li>\n
\nHTTP Verbs<\/strong>
\n<\/b>Methods such as GET, POST, PUT and DELETE to interact with resources.<\/li>\n
\nEndpoints<\/strong>
\n<\/b>URLs indicating where a specific resource is located.<\/li>\n
\nData Format<\/strong>
\n<\/b>Usually JSON or XML.<\/li>\n<\/ol>\n
Practical Example: Phone Number Verification with HLR Lookup<\/h3>\n
Phone number verification using We can get more information about the phone number in particular if it is a mobile number in the JSON file of the response.<\/p>\n Response format<\/strong><\/p>\n If we go into detail, apart from indicating whether the number is valid or invalid, we can obtain information about the telephone operator, the type of line, the international format of the number… If you want to know if the number is valid you should look at the IMSI, MCC, MNC and MCCMNC fields. All these checks are performed by the validation api and displayed in the value of the “reachable” field.<\/p>\n The The IMSI is composed of three parts:<\/p>\n The To verify if a phone number is true using the IMSI:<\/p>\n If you have an IMSI 214071234567890, you can break it down like this:<\/p>\n By verifying the MCC and MNC, you can confirm that the phone number belongs to a Movistar subscriber in Spain, which helps validate its authenticity.<\/p>\n “id”: “364215”,<\/p>\n “term”: “34677934019”,<\/p>\n “request_id”: “364215”,<\/p>\n “result_code”: “101”,<\/p>\n “result_type”: “Connected”,<\/p>\n “result”: {<\/p>\n “phone_number”: “+34677934019”,<\/p>\n “number_type”: “mobile”,<\/p>\n “timezone”: “Atlantic\/Canary”,<\/p>\n “format”: {<\/p>\n “e164”: “+34677934019”,<\/p>\n “international”: “+34 677 93 40 19”,<\/p>\n “national”: “677 93 40 19”,<\/p>\n “rfc3966”: “tel:+34-677-93-40-19”<\/p>\n },<\/p>\n “is_ported”: true,<\/p>\n “reachable”: “connected”,<\/p>\n “processing_status”: “completed”,<\/p>\n “imsi”: “214040000000000”,<\/p>\n “current_network”: {<\/p>\n “country_iso2”: “EN”,<\/p>\n “country_prefix”: “34”,<\/p>\n “country_name”: “Spain”,<\/p>\n “mccmnc”: “21404”,<\/p>\n “mcc”: “214”,<\/p>\n “mnc”: “04”,<\/p>\n “area”: “ES”,<\/p>\n “network_name”: “Yoigo”.<\/p>\n },<\/p>\n “original_network”: {<\/p>\n “country_iso2”: “EN”,<\/p>\n “country_prefix”: “34”,<\/p>\n “country_name”: “Spain”,<\/p>\n “mccmnc”: “21401”,<\/p>\n “mcc”: “214”,<\/p>\n “mnc”: “01”,<\/p>\n “area”: “ES”,<\/p>\n “network_name”: “Vodafone”.<\/p>\n }<\/p>\n }<\/p>\n }<\/p>\n To facilitate the use of the phone validator in your forms and applications, we have created a POSTMAN library<\/a> where you can download the api calls as well as code examples. In the case of our example, if we want to make a call in PHP, we must select this language within the Postman collection and the application itself will generate the PHP call to validate a phone number.<\/p>\n Capturing leads is expensive and will become more so every day. It is estimated that between 8-12% of the telephones captured on forms or during registration processes are erroneous. Data verification at the point of capture allows these errors to be detected and registration rates to be improved.<\/p>\n Once the lead is captured, it enters a “sales funnel” for its exploitation. If the phone number is wrong, we will be allocating resources that will never get a return. Our advice is to verify all phone numbers at the point of acquisition, but if you haven’t done so, at least verify the database to get a true picture of your potential customers.<\/p>\n We have seen the different ways to validate phone numbers<\/a>. We have seen that this service is indicated for the verification of mobile numbers during the registration process, improving the quality of the data and avoiding the capture of invalid numbers. Remember that you can apply HLR Lookup validation<\/a> to individual phones, massively to files with a high volume of numbers or automating the process with the number validation API.<\/p>\n We recommend that you review the validation API documentation<\/a> for the different phone<\/a> calls and if you want to have access to the validation libraries in the different programming languages. Although the API calls are Rest, it will always make it easier for you to integrate the service.<\/p>\n","protected":false},"excerpt":{"rendered":" In this article you will learn how to use the HLR Lookup API to validate phone numbers in real time. You will see how to perform individual validations, mass validations through files and how to automate the processes to create a number validator through the API. We will see several code examples, focusing on some … Read more<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[992],"tags":[],"class_list":["post-9457","post","type-post","status-publish","format-standard","hentry","category-verify-phones"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.verificaremails.com\/en\/wp-json\/wp\/v2\/posts\/9457","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.verificaremails.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.verificaremails.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.verificaremails.com\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.verificaremails.com\/en\/wp-json\/wp\/v2\/comments?post=9457"}],"version-history":[{"count":0,"href":"https:\/\/www.verificaremails.com\/en\/wp-json\/wp\/v2\/posts\/9457\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.verificaremails.com\/en\/wp-json\/wp\/v2\/media?parent=9457"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.verificaremails.com\/en\/wp-json\/wp\/v2\/categories?post=9457"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.verificaremails.com\/en\/wp-json\/wp\/v2\/tags?post=9457"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
\nHLR Lookup<\/strong>
\n<\/b>(Home Location Register Lookup<\/a>) allows you to know if a number is valid and active. This is useful for companies that want to ensure that their messages reach the right recipients.<\/p>\nVerification process<\/h4>\n
\n
\nYou send a request<\/strong>
\n<\/b> with the phone number to the HLR Lookup API.<\/li>\n
\nThe validation API queries<\/strong>
\n<\/b> the HLR database of the telephone operator.<\/li>\n
\nYou receive a response<\/strong>
\n<\/b> indicating the status of the phone number.<\/li>\n<\/ol>\nStep-by-step implementation using the verificaremails.com API<\/h4>\n
\n
\n<\/b> at verificaremails.com<\/a> and get your API key.<\/li>\n
\n<\/b> request to the HLR Lookup validation API.<\/li>\n<\/ol>\ncurl -X GET \"https:\/\/www.verificaremails.com\/api\/v1\/hlr?phone_number=1234567890\" \r\n-H \"apikey: TU_CLAVE_API\"<\/pre>\n
\n
\nInterpret the answer<\/strong>
\n<\/b>. An example of a response might be:<\/li>\n<\/ol>\n{\r\n\"status\": \"success\",\r\n\"data\": {\r\n\"phone_number\": \"1234567890\",\r\n\"valid\": true,\r\n\"carrier\": \"Movistar\",\r\n\"country\": \"ES\"\r\n}\r\n}<\/pre>\nIMSI<\/h3>\n
\nIMSI<\/strong>
\n<\/b> (International Mobile Subscriber Identity) is a unique number associated with each mobile network user. This number is stored on the SIM card and is used by mobile networks to identify subscribers.<\/p>\nIMSI Components<\/h3>\n
\n
\nMCC (Mobile Country Code)<\/strong>
\n<\/b>Three-digit code that identifies the subscriber’s country.<\/li>\n
\nMNC (Mobile Network Code)<\/strong>
\n<\/b>Two or three digit code that identifies the mobile network within that country.<\/li>\n
\nMSIN (Mobile Subscriber Identification Number)<\/strong>
\n<\/b>Unique number that identifies the subscriber within the mobile network.<\/li>\n<\/ol>\nMCC and MNC<\/h3>\n
\n
\n<\/b>CQI: Each country has a unique CQI. For example, Spain has MCC 214.<\/li>\n
\n<\/b>The operators within a country have different MNCs. For example, in Spain, Movistar has MNC 07.<\/li>\n<\/ul>\nMCCMNC<\/h3>\n
\nMCCMNC<\/strong>
\n<\/b> is the combination of the MCC and the MNC. It is used to uniquely identify a mobile network in a country. For example, the MCCMNC for Movistar in Spain would be 21407.<\/p>\nPhone Number Verification<\/h3>\n
\n
\n<\/b>Extract the IMSI from the SIM card of the phone.<\/li>\n
\n<\/b>:<\/li>\n\n
\n<\/b>:<\/li>\n\n
Example<\/h3>\n
\n
\n<\/b>: 214 (Spain)<\/li>\n
\n<\/b>: 07 (Movistar)<\/li>\n
\n<\/b>: 1234567890 (Subscriber’s Unique Identifier)<\/li>\n<\/ul>\n{<\/pre>\nHow to create a telephone number validator with PHP<\/h2>\n
<\/p>\nWhy validate phone numbers<\/h2>\n
Conclusions<\/h2>\n