{"id":346,"date":"2018-04-16T10:33:46","date_gmt":"2018-04-16T00:33:46","guid":{"rendered":"https:\/\/developers.messagemedia.com\/?p=346"},"modified":"2018-04-16T10:33:46","modified_gmt":"2018-04-16T00:33:46","slug":"know-the-details-behind-every-phone-number","status":"publish","type":"blog","link":"https:\/\/messagemedia.com\/au\/blog\/know-the-details-behind-every-phone-number\/","title":{"rendered":"Know the details behind every phone number"},"content":{"rendered":"<p>Did you know that over 98% of text messages are opened, while only 22% of emails are opened? Customers respond to SMS and this behaviour can be very powerful for businesses. Unless you can connect with your customers seamlessly, any attempt to engage and retain them will frustrate them. They will either abandon your business for a competitor, or simply find a better solution to the issue you\u2019re helping them solve. It\u2019s crucial to stay connected with your customers.<\/p>\n<p>You shouldn\u2019t have to spend on unnecessary SMS to invalid numbers. Nor should you be struggling with authenticating phone numbers. \u00a0To help our clients combat these challenges and countless others, we&#8217;ve built the MessageMedia Lookups API.<\/p>\n<h3>Why Lookups API?<\/h3>\n<p>Lookups can be used to identify carriers, isolate invalid numbers and separate landlines from mobile phones (US). Our Lookups service also provides basic number insights to help you keep your contact numbers organized. You can clean up your database and extract the numbers with an invalid area code, numbers that are too long, too short or use unrecognisable letters and characters. Some number types don&#8217;t accept all communications &#8211; for instance, most landline numbers can&#8217;t accept SMS.\u00a0 Why pay for an SMS to a landline number that can&#8217;t be received?<\/p>\n<h3>How do I use the Lookups API?<\/h3>\n<p>Let\u2019s break it down into three basic steps:<\/p>\n<ul>\n<li>Supply us with the phone numbers you\u2019d like to check<\/li>\n<li>Our Lookups endpoint identifies legitimate numbers, their carriers, country of origin and phone type (mobile or landline)<\/li>\n<li>Our Lookups endpoint sends the data back to you<\/li>\n<\/ul>\n<p>This is how you would lookup a number in <a href=\"https:\/\/github.com\/messagemedia\/lookups-python-sdk\">Python<\/a><\/p>\n<pre><span class=\"pl-k\">from<\/span> message_media_lookups.message_media_lookups_client <span class=\"pl-k\">import<\/span> MessageMediaLookupsClient\n<span class=\"pl-k\">import<\/span> json\n\nbasic_auth_user_name <span class=\"pl-k\">=<\/span> <span class=\"pl-s\"><span class=\"pl-pds\">'<\/span>YOUR_API_KEY<span class=\"pl-pds\">'<\/span><\/span> \nbasic_auth_password <span class=\"pl-k\">=<\/span> <span class=\"pl-s\"><span class=\"pl-pds\">'<\/span>YOUR_API_SECRET<span class=\"pl-pds\">'<\/span><\/span>\n\nclient <span class=\"pl-k\">=<\/span> MessageMediaLookupsClient(basic_auth_user_name, basic_auth_password)\n\nlookups_controller <span class=\"pl-k\">=<\/span> client.lookups\n\nphone_number <span class=\"pl-k\">=<\/span> <span class=\"pl-s\"><span class=\"pl-pds\">'<\/span>YOUR_MOBILE_NUMBER<span class=\"pl-pds\">'<\/span><\/span>\noptions <span class=\"pl-k\">=<\/span> <span class=\"pl-s\"><span class=\"pl-pds\">'<\/span>carrier,type<span class=\"pl-pds\">'<\/span><\/span>\n\nresult <span class=\"pl-k\">=<\/span> lookups_controller.get_lookup_a_phone_number(phone_number, options)<\/pre>\n<p>And this is how it would look like in <a href=\"https:\/\/github.com\/messagemedia\/lookups-nodejs-sdk\">Node.js<\/a><\/p>\n<pre><span class=\"pl-k\">const<\/span> <span class=\"pl-c1\">sdk<\/span> <span class=\"pl-k\">=<\/span> <span class=\"pl-c1\">require<\/span>(<span class=\"pl-s\"><span class=\"pl-pds\">'<\/span>messagemedia-lookups-sdk<span class=\"pl-pds\">'<\/span><\/span>);\n\n\n<span class=\"pl-smi\">sdk<\/span>.<span class=\"pl-smi\">Configuration<\/span>.<span class=\"pl-smi\">basicAuthUserName<\/span> <span class=\"pl-k\">=<\/span> <span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>YOUR_API_KEY<span class=\"pl-pds\">\"<\/span><\/span>; \n<span class=\"pl-smi\">sdk<\/span>.<span class=\"pl-smi\">Configuration<\/span>.<span class=\"pl-smi\">basicAuthPassword<\/span> <span class=\"pl-k\">=<\/span> <span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>YOUR_API_SECRET<span class=\"pl-pds\">\"<\/span><\/span>; \n<span class=\"pl-k\">var<\/span> controller <span class=\"pl-k\">=<\/span> <span class=\"pl-smi\">sdk<\/span>.<span class=\"pl-smi\">LookupsController<\/span>;\n\n<span class=\"pl-k\">var<\/span> phoneNumber <span class=\"pl-k\">=<\/span> <span class=\"pl-s\"><span class=\"pl-pds\">\"<\/span>YOUR_MOBILE_NUMBER<span class=\"pl-pds\">\"<\/span><\/span>;\n<span class=\"pl-k\">var<\/span> options <span class=\"pl-k\">=<\/span> <span class=\"pl-s\"><span class=\"pl-pds\">'<\/span>carrier,type<span class=\"pl-pds\">'<\/span><\/span>;\n\n<span class=\"pl-smi\">controller<\/span>.<span class=\"pl-en\">getLookupAPhoneNumber<\/span>(phoneNumber, options, <span class=\"pl-k\">function<\/span>(<span class=\"pl-smi\">error<\/span>, <span class=\"pl-smi\">response<\/span>, <span class=\"pl-smi\">context<\/span>) {\n  <span class=\"pl-en\">console<\/span>.<span class=\"pl-c1\">log<\/span>(response)\n});<\/pre>\n<p>&nbsp;<\/p>\n<p>A typical response body from the lookups endpoint will have the following structure:<\/p>\n<pre><span class=\"token punctuation\">{<\/span> \n<span class=\"token string oneLine\">  \"country_code\"<\/span><span class=\"token punctuation\">:<\/span> <span class=\"token string oneLine\">\"AU\"<\/span><span class=\"token punctuation\">,<\/span> \n<span class=\"token string oneLine\">  \"phone_number\"<\/span><span class=\"token punctuation\">:<\/span> <span class=\"token string oneLine\">\"+61491570156\"<\/span><span class=\"token punctuation\">,<\/span> \n<span class=\"token string oneLine\">  \"type\"<\/span><span class=\"token punctuation\">:<\/span> <span class=\"token string oneLine\">\"mobile\"<\/span><span class=\"token punctuation\">,<\/span> \n<span class=\"token string oneLine\">  \"carrier\"<\/span><span class=\"token punctuation\">:<\/span> <span class=\"token punctuation\">{<\/span> \n<span class=\"token string oneLine\">      \"name\"<\/span><span class=\"token punctuation\">:<\/span> <span class=\"token string oneLine\">\"Telstra\"<\/span> \n<span class=\"token punctuation\">   }<\/span> \n<span class=\"token punctuation\">}<\/span><\/pre>\n<p>If neither of those are your go-to programming languages, we\u2019ve got SDKs for <a href=\"https:\/\/github.com\/messagemedia\/lookups-ruby-sdk\/\">Ruby<\/a>, <a href=\"https:\/\/github.com\/messagemedia\/lookups-java-sdk\/\">Java<\/a>, <a href=\"https:\/\/github.com\/messagemedia\/lookups-csharp-sdk\/\">C#<\/a> and <a href=\"https:\/\/github.com\/messagemedia\/lookups-php-sdk\/\">PHP<\/a>. If SDKs aren&#8217;t your thing, read up on our <a href=\"https:\/\/developers.messagemedia.com\/code\/lookups-api-documentation\/\">API reference documentation<\/a>\u00a0to connect your website or application.<\/p>\n<p>&nbsp;<\/p>\n<p>Getting better acquainted with the numbers in your contact database carries a host of benefits. From checking the validity, type and carrier records of phone numbers to reducing the number of failed or undeliverable messages sent. A simple call to our user-friendly REST API is all you need to retrieve detailed information on your contact numbers<strong><em>.<\/em><\/strong><\/p>\n","protected":false},"author":0,"featured_media":8962,"menu_order":236,"template":"page-blog-v2.php","meta":{"_acf_changed":false,"popular":false,"coming_soon":false,"link":"","footnotes":""},"blog_category":[37],"class_list":["post-346","blog","type-blog","status-publish","has-post-thumbnail","hentry","blog_category-developers"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.3 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Know the details behind every phone number - Sinch MessageMedia Australia<\/title>\n<meta name=\"description\" content=\"Did you know that over 98% of text messages are opened, while only 22% of emails are opened? Customers respond to SMS and this behaviour can be very powerful for businesses. Unless you can connect with your customers seamlessly, any attempt to engage and retain them will frustrate them. Australia\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/messagemedia.com\/au\/blog\/know-the-details-behind-every-phone-number\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Know the details behind every phone number - Sinch MessageMedia\" \/>\n<meta property=\"og:description\" content=\"Did you know that over 98% of text messages are opened, while only 22% of emails are opened? Customers respond to SMS and this behaviour can be very powerful for businesses. Unless you can connect with your customers seamlessly, any attempt to engage and retain them will frustrate them.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/messagemedia.com\/au\/blog\/know-the-details-behind-every-phone-number\/\" \/>\n<meta property=\"og:site_name\" content=\"Sinch MessageMedia\" \/>\n<meta property=\"og:image\" content=\"https:\/\/messagemedia.com\/wp-content\/uploads\/2018\/04\/nick-hillier-339049-unsplash-scaled-e1591852096679.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1024\" \/>\n\t<meta property=\"og:image:height\" content=\"325\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/blog\\\/know-the-details-behind-every-phone-number\\\/\",\"url\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/blog\\\/know-the-details-behind-every-phone-number\\\/\",\"name\":\"Know the details behind every phone number - Sinch MessageMedia\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/blog\\\/know-the-details-behind-every-phone-number\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/blog\\\/know-the-details-behind-every-phone-number\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/messagemedia.com\\\/wp-content\\\/uploads\\\/2018\\\/04\\\/nick-hillier-339049-unsplash-scaled-e1591852096679.jpg\",\"datePublished\":\"2018-04-16T00:33:46+00:00\",\"description\":\"Did you know that over 98% of text messages are opened, while only 22% of emails are opened? Customers respond to SMS and this behaviour can be very powerful for businesses. Unless you can connect with your customers seamlessly, any attempt to engage and retain them will frustrate them.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/blog\\\/know-the-details-behind-every-phone-number\\\/#breadcrumb\"},\"inLanguage\":\"en-AU\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/messagemedia.com\\\/au\\\/blog\\\/know-the-details-behind-every-phone-number\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-AU\",\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/blog\\\/know-the-details-behind-every-phone-number\\\/#primaryimage\",\"url\":\"https:\\\/\\\/messagemedia.com\\\/wp-content\\\/uploads\\\/2018\\\/04\\\/nick-hillier-339049-unsplash-scaled-e1591852096679.jpg\",\"contentUrl\":\"https:\\\/\\\/messagemedia.com\\\/wp-content\\\/uploads\\\/2018\\\/04\\\/nick-hillier-339049-unsplash-scaled-e1591852096679.jpg\",\"width\":1024,\"height\":325,\"caption\":\"nick hillier 339049 unsplash scaled e1591852096679\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/blog\\\/know-the-details-behind-every-phone-number\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Blog\",\"item\":\"https:\\\/\\\/messagemedia.com\\\/us\\\/blog\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Know the details behind every phone number\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/#website\",\"url\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/\",\"name\":\"Sinch MessageMedia\",\"description\":\"Business SMS &amp; Messaging Platform\",\"publisher\":{\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-AU\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/#organization\",\"name\":\"Sinch MessageMedia\",\"url\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-AU\",\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/messagemedia.com\\\/wp-content\\\/uploads\\\/2024\\\/03\\\/logo-mm-sinch.svg\",\"contentUrl\":\"https:\\\/\\\/messagemedia.com\\\/wp-content\\\/uploads\\\/2024\\\/03\\\/logo-mm-sinch.svg\",\"width\":1,\"height\":1,\"caption\":\"Sinch MessageMedia\"},\"image\":{\"@id\":\"https:\\\/\\\/messagemedia.com\\\/au\\\/#\\\/schema\\\/logo\\\/image\\\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Know the details behind every phone number - Sinch MessageMedia Australia","description":"Did you know that over 98% of text messages are opened, while only 22% of emails are opened? Customers respond to SMS and this behaviour can be very powerful for businesses. Unless you can connect with your customers seamlessly, any attempt to engage and retain them will frustrate them. Australia","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/messagemedia.com\/au\/blog\/know-the-details-behind-every-phone-number\/","og_locale":"en_US","og_type":"article","og_title":"Know the details behind every phone number - Sinch MessageMedia","og_description":"Did you know that over 98% of text messages are opened, while only 22% of emails are opened? Customers respond to SMS and this behaviour can be very powerful for businesses. Unless you can connect with your customers seamlessly, any attempt to engage and retain them will frustrate them.","og_url":"https:\/\/messagemedia.com\/au\/blog\/know-the-details-behind-every-phone-number\/","og_site_name":"Sinch MessageMedia","og_image":[{"width":1024,"height":325,"url":"https:\/\/messagemedia.com\/wp-content\/uploads\/2018\/04\/nick-hillier-339049-unsplash-scaled-e1591852096679.jpg","type":"image\/jpeg"}],"twitter_card":"summary_large_image","schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/messagemedia.com\/au\/blog\/know-the-details-behind-every-phone-number\/","url":"https:\/\/messagemedia.com\/au\/blog\/know-the-details-behind-every-phone-number\/","name":"Know the details behind every phone number - Sinch MessageMedia","isPartOf":{"@id":"https:\/\/messagemedia.com\/au\/#website"},"primaryImageOfPage":{"@id":"https:\/\/messagemedia.com\/au\/blog\/know-the-details-behind-every-phone-number\/#primaryimage"},"image":{"@id":"https:\/\/messagemedia.com\/au\/blog\/know-the-details-behind-every-phone-number\/#primaryimage"},"thumbnailUrl":"https:\/\/messagemedia.com\/wp-content\/uploads\/2018\/04\/nick-hillier-339049-unsplash-scaled-e1591852096679.jpg","datePublished":"2018-04-16T00:33:46+00:00","description":"Did you know that over 98% of text messages are opened, while only 22% of emails are opened? Customers respond to SMS and this behaviour can be very powerful for businesses. Unless you can connect with your customers seamlessly, any attempt to engage and retain them will frustrate them.","breadcrumb":{"@id":"https:\/\/messagemedia.com\/au\/blog\/know-the-details-behind-every-phone-number\/#breadcrumb"},"inLanguage":"en-AU","potentialAction":[{"@type":"ReadAction","target":["https:\/\/messagemedia.com\/au\/blog\/know-the-details-behind-every-phone-number\/"]}]},{"@type":"ImageObject","inLanguage":"en-AU","@id":"https:\/\/messagemedia.com\/au\/blog\/know-the-details-behind-every-phone-number\/#primaryimage","url":"https:\/\/messagemedia.com\/wp-content\/uploads\/2018\/04\/nick-hillier-339049-unsplash-scaled-e1591852096679.jpg","contentUrl":"https:\/\/messagemedia.com\/wp-content\/uploads\/2018\/04\/nick-hillier-339049-unsplash-scaled-e1591852096679.jpg","width":1024,"height":325,"caption":"nick hillier 339049 unsplash scaled e1591852096679"},{"@type":"BreadcrumbList","@id":"https:\/\/messagemedia.com\/au\/blog\/know-the-details-behind-every-phone-number\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/messagemedia.com\/au\/"},{"@type":"ListItem","position":2,"name":"Blog","item":"https:\/\/messagemedia.com\/us\/blog\/"},{"@type":"ListItem","position":3,"name":"Know the details behind every phone number"}]},{"@type":"WebSite","@id":"https:\/\/messagemedia.com\/au\/#website","url":"https:\/\/messagemedia.com\/au\/","name":"Sinch MessageMedia","description":"Business SMS &amp; Messaging Platform","publisher":{"@id":"https:\/\/messagemedia.com\/au\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/messagemedia.com\/au\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-AU"},{"@type":"Organization","@id":"https:\/\/messagemedia.com\/au\/#organization","name":"Sinch MessageMedia","url":"https:\/\/messagemedia.com\/au\/","logo":{"@type":"ImageObject","inLanguage":"en-AU","@id":"https:\/\/messagemedia.com\/au\/#\/schema\/logo\/image\/","url":"https:\/\/messagemedia.com\/wp-content\/uploads\/2024\/03\/logo-mm-sinch.svg","contentUrl":"https:\/\/messagemedia.com\/wp-content\/uploads\/2024\/03\/logo-mm-sinch.svg","width":1,"height":1,"caption":"Sinch MessageMedia"},"image":{"@id":"https:\/\/messagemedia.com\/au\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/messagemedia.com\/au\/wp-json\/wp\/v2\/blog\/346","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/messagemedia.com\/au\/wp-json\/wp\/v2\/blog"}],"about":[{"href":"https:\/\/messagemedia.com\/au\/wp-json\/wp\/v2\/types\/blog"}],"version-history":[{"count":0,"href":"https:\/\/messagemedia.com\/au\/wp-json\/wp\/v2\/blog\/346\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/messagemedia.com\/au\/wp-json\/wp\/v2\/media\/8962"}],"wp:attachment":[{"href":"https:\/\/messagemedia.com\/au\/wp-json\/wp\/v2\/media?parent=346"}],"wp:term":[{"taxonomy":"blog_category","embeddable":true,"href":"https:\/\/messagemedia.com\/au\/wp-json\/wp\/v2\/blog_category?post=346"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}