{"id":2771,"date":"2022-07-12T15:24:07","date_gmt":"2022-07-12T15:24:07","guid":{"rendered":"https:\/\/www.reloadly.com\/blog\/?p=2771"},"modified":"2022-08-22T10:33:24","modified_gmt":"2022-08-22T10:33:24","slug":"how-to-detect-ongoing-promotions-in-your-country-using-reloadly","status":"publish","type":"post","link":"https:\/\/blog.reloadly.com\/blog\/how-to-detect-ongoing-promotions-in-your-country-using-reloadly\/","title":{"rendered":"How to detect ongoing promotions in your country using Reloadly"},"content":{"rendered":"<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_46 ez-toc-wrap-left counter-hierarchy ez-toc-counter ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title\">Table of Contents<\/p>\n<span class=\"ez-toc-title-toggle\"><a href=\"#\" class=\"ez-toc-pull-right ez-toc-btn ez-toc-btn-xs ez-toc-btn-default ez-toc-toggle\" aria-label=\"ez-toc-toggle-icon-1\"><label for=\"item-69d2ce27bd957\" aria-label=\"Table of Content\"><span style=\"display: flex;align-items: center;width: 35px;height: 30px;justify-content: center;direction:ltr;\"><svg style=\"fill: #000000;color:#000000\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" class=\"list-377408\" width=\"20px\" height=\"20px\" viewBox=\"0 0 24 24\" fill=\"none\"><path d=\"M6 6H4v2h2V6zm14 0H8v2h12V6zM4 11h2v2H4v-2zm16 0H8v2h12v-2zM4 16h2v2H4v-2zm16 0H8v2h12v-2z\" fill=\"currentColor\"><\/path><\/svg><svg style=\"fill: #000000;color:#000000\" class=\"arrow-unsorted-368013\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"10px\" height=\"10px\" viewBox=\"0 0 24 24\" version=\"1.2\" baseProfile=\"tiny\"><path d=\"M18.2 9.3l-6.2-6.3-6.2 6.3c-.2.2-.3.4-.3.7s.1.5.3.7c.2.2.4.3.7.3h11c.3 0 .5-.1.7-.3.2-.2.3-.5.3-.7s-.1-.5-.3-.7zM5.8 14.7l6.2 6.3 6.2-6.3c.2-.2.3-.5.3-.7s-.1-.5-.3-.7c-.2-.2-.4-.3-.7-.3h-11c-.3 0-.5.1-.7.3-.2.2-.3.5-.3.7s.1.5.3.7z\"\/><\/svg><\/span><\/label><input  type=\"checkbox\" id=\"item-69d2ce27bd957\"><\/a><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1 eztoc-visibility-hide-by-default' ><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/blog.reloadly.com\/blog\/how-to-detect-ongoing-promotions-in-your-country-using-reloadly\/#Getting_details_of_all_the_promotions_within_your_country\" title=\"Getting details of all the promotions within your country\">Getting details of all the promotions within your country<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-3'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/blog.reloadly.com\/blog\/how-to-detect-ongoing-promotions-in-your-country-using-reloadly\/#Resources\" title=\"Resources\">Resources<\/a><\/li><\/ul><\/nav><\/div>\n\n<div style=\"height:40px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Promotions are a great way to derive value for every top-up you make. Certain operators carry out periodic promotions every now and then. Examples of promotions carried out by telecom operators include:<\/p>\n\n\n\n<ul><li>Additional free credits for top-ups of a particular value<\/li><li>Additional data bundles for top-ups made during particular public holidays e.g Mother\u2019s day<\/li><\/ul>\n\n\n\n<p>As a Reloadly user, it would be great to be able to view ongoing promotions for all the operators within your country. This guide will show you how to achieve that.<\/p>\n\n\n\n<p>The steps to be followed in this guide are as follows:<\/p>\n\n\n\n<ul><li>Getting your access token<\/li><li>Getting details of all the promotions within your country<\/li><\/ul>\n\n\n\n<p><em>You can get your access token by following the steps in this <a href=\"https:\/\/developers.reloadly.com\/airtime\/quickstart\" target=\"_blank\" rel=\"noreferrer noopener\">quickstart<\/a>.<\/em><\/p>\n\n\n\n<div style=\"height:42px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Getting_details_of_all_the_promotions_within_your_country\"><\/span>Getting details of all the promotions within your country<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<div style=\"height:40px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Suppose your country is Ethiopia and you want to find out if there are any ongoing promotions, you can make a request to an endpoint that takes Ethiopia\u2019s two letter ISO code as a parameter and returns a list of ongoing promotions.&nbsp;<\/p>\n\n\n\n<p>The code sample below is written in cURL and shows how to achieve this<\/p>\n\n\n\n<div style=\"height:39px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<pre class=\"wp-block-code\"><code>curl -i -X GET \\\n  https:\/\/topups-sandbox.reloadly.com\/promotions\/country-codes\/ET \\\n  -H 'Authorization: Bearer &lt;YOUR_TOKEN_HERE&gt;'\n<\/code><\/pre>\n\n\n\n<div style=\"height:40px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>If your request is successful, you receive a data object containing information on Ethiopia\u2019s promotions<\/p>\n\n\n\n<div style=\"height:39px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<pre class=\"wp-block-code\"><code>&#091;\n  {\n    \"id\": 5665,\n    \"promotionId\": 5665,\n    \"operatorId\": 130,\n    \"title\": \"Ethiotelecom Ethiopia From 01 Mar 2021 00:00 To 30 Jun 2021 23:59 (GMT+03:00)\",\n    \"title2\": \"Bonus 50%\",\n    \"description\": \"We are pleased to inform you the 50% IAT promotional bonus for Ethiotelecom is extended for additional four months as per below details.&lt;br \/&gt;&lt;br \/&gt;&lt;strong&gt;KEY INFORMATION:&lt;\/strong&gt;&lt;br \/&gt;Bonus value:&lt;strong&gt; 50%&lt;\/strong&gt;&lt;br \/&gt;Bonus receivers:&lt;strong&gt; &amp;ge;50 ETB recharge during the promo period&lt;\/strong&gt;&lt;br \/&gt;Promotion date: &lt;strong&gt;March 01,2021 up to June 30, 2021&lt;\/strong&gt;&lt;br \/&gt;Bonus validity period:&lt;strong&gt; 15 days&lt;br \/&gt;&lt;br \/&gt;&lt;img alt=\\\"\\\" src=\\\"https:\/\/i.postimg.cc\/g2prm1fL\/Picture1-Ethio.png\\\" style=\\\"height:245px; width:651px\\\" \/&gt;&lt;\/strong&gt;\",\n    \"startDate\": \"2021-03-01 02:00:00\",\n    \"endDate\": \"2021-07-01 00:59:00\",\n    \"denominations\": null,\n    \"localDenominations\": \"ETB 50 and up\"\n  },\n  {\n    \"id\": 5887,\n    \"promotionId\": 5887,\n    \"operatorId\": 130,\n    \"title\": \"Ethiotelecom Ethiopia From 30 Apr 2021 00:01 To 04 May 2021 23:59 (GMT+03:00)\",\n    \"title2\": \"Flexi Package\",\n    \"description\": \"To Celebrate&amp;nbsp;&lt;strong&gt;Easter Holiday&amp;nbsp;&lt;\/strong&gt;in Ethiopia&lt;strong&gt;,&lt;\/strong&gt;&amp;nbsp;Ethio Telecom has launched a promotional international airtime top up of&amp;nbsp;&lt;strong&gt;flexi package Easter holiday bonus from&amp;nbsp;&lt;\/strong&gt;April 30th to May 04th. 2021&lt;br \/&gt;&lt;br \/&gt;&lt;strong&gt;&lt;u&gt;Promoton Details&lt;\/u&gt;&lt;\/strong&gt;&lt;br \/&gt;* Bonus is valid for 5 Days (usable).&lt;br \/&gt;* IAT receivers shall receive 50 Br. &amp;ge; recharge during incentive period&lt;br \/&gt;Flexi package details:&lt;br \/&gt;o&amp;nbsp;&amp;nbsp;&amp;nbsp;50Br &amp;ge;&amp;nbsp;Receiver received value &amp;lt; 100Br:&amp;nbsp;&lt;strong&gt;1,340&lt;\/strong&gt;&amp;nbsp;flexi unit bonus&lt;br \/&gt;o&amp;nbsp;&amp;nbsp;&amp;nbsp;100Br &amp;le; Receiver received value &amp;lt; 200Br:&amp;nbsp;&lt;strong&gt;3,416&lt;\/strong&gt;&amp;nbsp;flexi unit bonus&lt;br \/&gt;o&amp;nbsp;&amp;nbsp;&amp;nbsp;Receiver received value &amp;ge; 200:&amp;nbsp;&lt;strong&gt;8,429&lt;\/strong&gt;&amp;nbsp;flexi unit bonus&lt;br \/&gt;o&amp;nbsp;&amp;nbsp;&amp;nbsp;&lt;strong&gt;&lt;em&gt;1 Minute = 6 Flexi, 1 SMS = 2 Flexi, 1 MB = 2 Flexi&lt;\/em&gt;&lt;\/strong&gt;\",\n    \"startDate\": \"2021-04-30 01:01:00\",\n    \"endDate\": \"2021-05-05 00:59:00\",\n    \"denominations\": \"Bir 50 and abpve\",\n    \"localDenominations\": \"Bir 50 and Above\"\n  },\n  {\n    \"id\": 5903,\n    \"promotionId\": 5903,\n    \"operatorId\": 130,\n    \"title\": \"Ethiotelecom Ethiopia From 05 May 2021 00:00 To 30 Jun 2021 23:59 (GMT+03:00)\",\n    \"title2\": \"Bonus 50%\",\n    \"description\": \"We are pleased to inform you the 50% IAT promotional bonus for Ethiotelecom is extended for additional four months as per below details.&lt;br \/&gt;&lt;br \/&gt;&lt;strong&gt;KEY INFORMATION:&lt;\/strong&gt;&lt;br \/&gt;Bonus value:&lt;strong&gt; 50%&lt;\/strong&gt;&lt;br \/&gt;Bonus receivers:&lt;strong&gt; &amp;ge;50 ETB recharge during the promo period&lt;\/strong&gt;&lt;br \/&gt;Promotion date: &lt;strong&gt;March 01,2021 up to June 30, 2021, except April 30 - May 4th, 2021&lt;\/strong&gt;&lt;br \/&gt;Bonus validity period:&lt;strong&gt; 15 days&lt;br \/&gt;&lt;br \/&gt;&lt;img alt=\\\"\\\" src=\\\"https:\/\/i.postimg.cc\/g2prm1fL\/Picture1-Ethio.png\\\" style=\\\"height:245px; width:651px\\\" \/&gt;&lt;\/strong&gt;\",\n    \"startDate\": \"2021-05-05 01:00:00\",\n    \"endDate\": \"2021-07-01 00:59:00\",\n    \"denominations\": null,\n    \"localDenominations\": \"ETB 50 and up\"\n  }\n]\n<\/code><\/pre>\n\n\n\n<div style=\"height:38px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h3 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Resources\"><\/span>Resources<span class=\"ez-toc-section-end\"><\/span><\/h3>\n\n\n\n<p><a href=\"https:\/\/docs.reloadly.com\/airtime\/\" target=\"_blank\" rel=\"noreferrer noopener\">Reloadly Airtime API<\/a><\/p>\n\n\n\n<p><a href=\"https:\/\/developers.reloadly.com\/\" target=\"_blank\" rel=\"noreferrer noopener\">Reloadly Developer Documentation<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Learn how to view details of all the ongoing airtime, data, or bundle promotions within your country. This guide was written with code samples in test mode. Code samples in responses may be abbreviated.<\/p>\n","protected":false},"author":17,"featured_media":2756,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[274],"tags":[11,282,396,397],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v15.7 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>How to detect ongoing promotions in your country using Reloadly - Reloadly<\/title>\n<meta name=\"description\" content=\"Reloadly Resources. Insights, Info and Analysis For The Mobile Airtime API Community\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.reloadly.com\/blog\/how-to-detect-ongoing-promotions-in-your-country-using-reloadly\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How to detect ongoing promotions in your country using Reloadly - Reloadly\" \/>\n<meta property=\"og:description\" content=\"Reloadly Resources. Insights, Info and Analysis For The Mobile Airtime API Community\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.reloadly.com\/blog\/how-to-detect-ongoing-promotions-in-your-country-using-reloadly\/\" \/>\n<meta property=\"og:site_name\" content=\"Reloadly\" \/>\n<meta property=\"article:published_time\" content=\"2022-07-12T15:24:07+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2022-08-22T10:33:24+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/blog.reloadly.com\/blog\/wp-content\/uploads\/2022\/07\/cover-image-blogs.png\" \/>\n\t<meta property=\"og:image:width\" content=\"641\" \/>\n\t<meta property=\"og:image:height\" content=\"334\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\">\n\t<meta name=\"twitter:data1\" content=\"3 minutes\">\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.reloadly.com\/blog\/#organization\",\"name\":\"Reloadly\",\"url\":\"https:\/\/www.reloadly.com\/blog\/\",\"sameAs\":[],\"logo\":{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/www.reloadly.com\/blog\/#logo\",\"inLanguage\":\"en-US\",\"url\":\"https:\/\/blog.reloadly.com\/blog\/wp-content\/uploads\/2020\/11\/logo-1.svg\",\"width\":100,\"height\":100,\"caption\":\"Reloadly\"},\"image\":{\"@id\":\"https:\/\/www.reloadly.com\/blog\/#logo\"}},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.reloadly.com\/blog\/#website\",\"url\":\"https:\/\/www.reloadly.com\/blog\/\",\"name\":\"Reloadly\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/www.reloadly.com\/blog\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":\"https:\/\/www.reloadly.com\/blog\/?s={search_term_string}\",\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/www.reloadly.com\/blog\/how-to-detect-ongoing-promotions-in-your-country-using-reloadly\/#primaryimage\",\"inLanguage\":\"en-US\",\"url\":\"https:\/\/blog.reloadly.com\/blog\/wp-content\/uploads\/2022\/07\/cover-image-blogs.png\",\"width\":641,\"height\":334},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.reloadly.com\/blog\/how-to-detect-ongoing-promotions-in-your-country-using-reloadly\/#webpage\",\"url\":\"https:\/\/www.reloadly.com\/blog\/how-to-detect-ongoing-promotions-in-your-country-using-reloadly\/\",\"name\":\"How to detect ongoing promotions in your country using Reloadly - Reloadly\",\"isPartOf\":{\"@id\":\"https:\/\/www.reloadly.com\/blog\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/www.reloadly.com\/blog\/how-to-detect-ongoing-promotions-in-your-country-using-reloadly\/#primaryimage\"},\"datePublished\":\"2022-07-12T15:24:07+00:00\",\"dateModified\":\"2022-08-22T10:33:24+00:00\",\"description\":\"Reloadly Resources. Insights, Info and Analysis For The Mobile Airtime API Community\",\"breadcrumb\":{\"@id\":\"https:\/\/www.reloadly.com\/blog\/how-to-detect-ongoing-promotions-in-your-country-using-reloadly\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.reloadly.com\/blog\/how-to-detect-ongoing-promotions-in-your-country-using-reloadly\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.reloadly.com\/blog\/how-to-detect-ongoing-promotions-in-your-country-using-reloadly\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"item\":{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.reloadly.com\/blog\/\",\"url\":\"https:\/\/www.reloadly.com\/blog\/\",\"name\":\"Home\"}},{\"@type\":\"ListItem\",\"position\":2,\"item\":{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.reloadly.com\/blog\/how-to-detect-ongoing-promotions-in-your-country-using-reloadly\/\",\"url\":\"https:\/\/www.reloadly.com\/blog\/how-to-detect-ongoing-promotions-in-your-country-using-reloadly\/\",\"name\":\"How to detect ongoing promotions in your country using Reloadly\"}}]},{\"@type\":\"Article\",\"@id\":\"https:\/\/www.reloadly.com\/blog\/how-to-detect-ongoing-promotions-in-your-country-using-reloadly\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.reloadly.com\/blog\/how-to-detect-ongoing-promotions-in-your-country-using-reloadly\/#webpage\"},\"author\":{\"@id\":\"https:\/\/www.reloadly.com\/blog\/#\/schema\/person\/2400042054e3b3009489e487224a6984\"},\"headline\":\"How to detect ongoing promotions in your country using Reloadly\",\"datePublished\":\"2022-07-12T15:24:07+00:00\",\"dateModified\":\"2022-08-22T10:33:24+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.reloadly.com\/blog\/how-to-detect-ongoing-promotions-in-your-country-using-reloadly\/#webpage\"},\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/www.reloadly.com\/blog\/#organization\"},\"image\":{\"@id\":\"https:\/\/www.reloadly.com\/blog\/how-to-detect-ongoing-promotions-in-your-country-using-reloadly\/#primaryimage\"},\"keywords\":\"airtime,developer,promotion,top-up\",\"articleSection\":\"Developer Blog\",\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/www.reloadly.com\/blog\/how-to-detect-ongoing-promotions-in-your-country-using-reloadly\/#respond\"]}]},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.reloadly.com\/blog\/#\/schema\/person\/2400042054e3b3009489e487224a6984\",\"name\":\"Raphael Ugwu\",\"image\":{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/www.reloadly.com\/blog\/#personlogo\",\"inLanguage\":\"en-US\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/656844c0101d37e5695eee915ed3a49d?s=96&d=mm&r=g\",\"caption\":\"Raphael Ugwu\"},\"url\":\"https:\/\/blog.reloadly.com\/blog\/author\/fullstackmafia\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","authors":[{"term_id":359,"user_id":17,"is_guest":0,"slug":"fullstackmafia","display_name":"Raphael Ugwu"}],"_links":{"self":[{"href":"https:\/\/blog.reloadly.com\/blog\/wp-json\/wp\/v2\/posts\/2771"}],"collection":[{"href":"https:\/\/blog.reloadly.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.reloadly.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.reloadly.com\/blog\/wp-json\/wp\/v2\/users\/17"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.reloadly.com\/blog\/wp-json\/wp\/v2\/comments?post=2771"}],"version-history":[{"count":4,"href":"https:\/\/blog.reloadly.com\/blog\/wp-json\/wp\/v2\/posts\/2771\/revisions"}],"predecessor-version":[{"id":3453,"href":"https:\/\/blog.reloadly.com\/blog\/wp-json\/wp\/v2\/posts\/2771\/revisions\/3453"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.reloadly.com\/blog\/wp-json\/wp\/v2\/media\/2756"}],"wp:attachment":[{"href":"https:\/\/blog.reloadly.com\/blog\/wp-json\/wp\/v2\/media?parent=2771"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.reloadly.com\/blog\/wp-json\/wp\/v2\/categories?post=2771"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.reloadly.com\/blog\/wp-json\/wp\/v2\/tags?post=2771"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}