Get operator by ID

With the /operators/{operatorid} endpoint, a user can fetch details of an operator by making a request with the operator's ID

Operator by ID

GET https://topups.reloadly.com/operators/{operatorid}

Path Parameters

Name	Type	Description
operatorId*	integer	This indicates the operator's ID

Query Parameters

Name	Type	Description
supports Geographical RechargePlans	boolean	Indicates if the supportsGeograhicalRechargePlans field should be returned. Default value is false
suggested AmountsMap	boolean	Indicates if the suggestedAmountsMap field should be returned. Default value is false
suggested Amounts	boolean	Indicates if the suggestedAmounts field should be returned. Default value is false

Headers

Name	Type	Description
Authorization*	string	Your access token is required as a bearer token in the request's header

200 This response is gotten when a successful response is made and a list of operators is retrieved

JSON

{
  "operatorId":200,
  "name":"Airtel India",
  "bundle":false,
  "data":false,
  "pin":false,
  "supportsGeographicalRechargePlans":true,
  "supportsLocalAmounts":false,
  "denominationType":"FIXED",
  "senderCurrencyCode":"USD",
  "senderCurrencySymbol":"$",
  "destinationCurrencyCode":"INR",
  "destinationCurrencySymbol":"₹",
  "commission":17.0,
  "internationalDiscount":17.0,
  "localDiscount":0.5,
  "mostPopularAmount":null,
  "mostPopularLocalAmount":null,
  "minAmount":null,
  "maxAmount":null,
  "localMinAmount":null,
  "localMaxAmount":null,
  "country":{
    "isoName":"IN",
    "name":"India"
  },
  "fx":{
    "rate":59,
    "currencyCode":"INR"
  },
  "logoUrls":[
    "https://s3.amazonaws.com/rld-operator/3f4a8bcd3268-size-1.png",
    "https://s3.amazonaws.com/rld-operator/3f4a8bcd3268-size-2.png",
    "https://s3.amazonaws.com/rld-operator/3f4a8bcd3268-size-3.png"
  ],
  "fixedAmounts":[
    
  ],
  "fixedAmountsDescriptions":[
    
  ],
  "localFixedAmounts":[
    
  ],
  "localFixedAmountsDescriptions":[
    
  ],
  "suggestedAmounts":[
    
  ],
  "suggestedAmountsMap":{
    
  },
  "additionalPlans":null,
  "geographicalRechargePlans":[
    {
      "locationCode":"AP",
      "locationName":"Andhra Pradesh",
      "fixedAmounts":[
        0.17,
        8.47,
        84.75
      ],
      "localAmounts":[
        20.00,
        500.00,
        5000.00
      ],
      "fixedAmountsDescriptions":{
        "0.31":"Get ISD Calling at discounted rates for 28 Days.",
        "8.47":"Get Talktime of Rs. 423.73",
        "84.75":"Get Talktime of Rs. 4237.29"
      },
      "localFixedAmountsDescriptions":{
        "18.00":"Get ISD Calling at discounted rates for 28 Days.",
        "100.00":"Get Talktime of Rs. 81.75",
        "5000.00":"Get Talktime of Rs. 4237.29"
      }
    },
    "locationCode":"DEL",
    "locationName":"Delhi",
    "fixedAmounts":[
      0.60,
      1.63,
      8.35
    ],
    "localAmounts":[
      26.00,
      51.00,
      501.00
    ],
    "fixedAmountsDescriptions":{
      "0.20":"Get 120 local/national SMS",
      "0.85":"Get 500 local/national SMS",
      "8.35":"Get 75 GB 4G/3G/2G Data"
    },
    "localFixedAmountsDescriptions":{
      "26.00":"Get 250 local/national SMS",
      "251.00":"Get 50 GB 4G/3G/2G Data",
      "501.00":"Get 75 GB 4G/3G/2G Data"
    }
  },
  "promotions":[
    
  ]

JSON (for Indian Operators)

{
   "id":200,
   "operatorId":200,
   "name":"Airtel India",
   "bundle":false,
   "data":false,
   "pin":false,
   "supportsLocalAmounts":false,
   "supportsGeographicalRechargePlans":true,
   "denominationType":"FIXED",
   "senderCurrencyCode":"NGN",
   "senderCurrencySymbol":"₦",
   "destinationCurrencyCode":"INR",
   "destinationCurrencySymbol":"₹",
   "commission":17.0,
   "internationalDiscount":17.0,
   "localDiscount":0.5,
   "mostPopularAmount":null,
   "mostPopularLocalAmount":null,
   "minAmount":null,
   "maxAmount":null,
   "localMinAmount":null,
   "localMaxAmount":null,
   "country":{
      "isoName":"IN",
      "name":"India"
   },
   "fx":{
      "rate":0.14094,
      "currencyCode":"INR"
   },
   "logoUrls":[
      "https://s3.amazonaws.com/rld-operator/48a34cc8-a395-43b2-848d-8caa7af71649-size-1.png",
      "https://s3.amazonaws.com/rld-operator/48a34cc8-a395-43b2-848d-8caa7af71649-size-2.png",
      "https://s3.amazonaws.com/rld-operator/48a34cc8-a395-43b2-848d-8caa7af71649-size-3.png"
   ],
   "fixedAmounts":[
      
   ],
   "fixedAmountsDescriptions":{
      
   },
   "localFixedAmounts":[
      
   ],
   "localFixedAmountsDescriptions":{
      
   },
   "suggestedAmounts":[
      
   ],
   "suggestedAmountsMap":{
      
   },
   "geographicalRechargePlans":[
      {
         "locationCode":"ASM",
         "locationName":"Assam",
         "fixedAmounts":[
            69.87,
            139.74,
            706.92,
            3542.82,
            7085.64,
            35432.31
         ],
         "localAmounts":[
            10.00,
            20.00,
            100.00,
            500.00,
            1000.00,
            5000.00
         ],
         "fixedAmountsPlanNames":{
            "0.17":"Topup Plan",
            "0.34":"Topup Plan",
            "1.72":"Topup Plan",
            "8.62":"Topup Plan",
            "17.24":"Topup Plan",
            "86.21":"Topup Plan"
         },
         "fixedAmountsDescriptions":{
            "69.87":"Get Talktime of Rs. 7.47. Validity : 0 Days. Talk time : 7.47",
            "139.74":"Get Talktime of Rs. 14.95. Validity : 0 Days. Talk time : 14.95",
            "706.92":"Get Talktime of Rs. 81.75. Validity : 0 Days. Talk time : 81.75",
            "3542.82":"Get Talktime of Rs. 423.73. Validity : 0 Days. Talk time : 423.73",
            "7085.64":"Get Talktime of Rs. 847.46. Validity : 0 Days. Talk time : 847.46",
            "35432.31":"Get Talktime of Rs. 4237.29. Validity : 0 Days. Talk time : 4237.29"
         },
         "localFixedAmountsPlanNames":{
            "10.00":"Topup Plan",
            "20.00":"Topup Plan",
            "100.00":"Topup Plan",
            "500.00":"Topup Plan",
            "1000.00":"Topup Plan",
            "5000.00":"Topup Plan"
         },
         "localFixedAmountsDescriptions":{
            "10.00":"Get Talktime of Rs. 7.47. Validity : 0 Days. Talk time : 7.47",
            "20.00":"Get Talktime of Rs. 14.95. Validity : 0 Days. Talk time : 14.95",
            "100.00":"Get Talktime of Rs. 81.75. Validity : 0 Days. Talk time : 81.75",
            "500.00":"Get Talktime of Rs. 423.73. Validity : 0 Days. Talk time : 423.73",
            "1000.00":"Get Talktime of Rs. 847.46. Validity : 0 Days. Talk time : 847.46",
            "5000.00":"Get Talktime of Rs. 4237.29. Validity : 0 Days. Talk time : 4237.29"
         }
      },
      {
         "locationCode":"PUN",
         "locationName":"Punjab",
         "fixedAmounts":[
            69.87,
            139.74,
            706.92,
            3542.82,
            7085.64,
            35432.31
         ],
         "localAmounts":[
            10.00,
            20.00,
            100.00,
            500.00,
            1000.00,
            5000.00
         ],
         "fixedAmountsPlanNames":{
            "0.17":"Topup Plan",
            "0.34":"Topup Plan",
            "1.72":"Topup Plan",
            "8.62":"Topup Plan",
            "17.24":"Topup Plan",
            "86.21":"Topup Plan"
         },
         "fixedAmountsDescriptions":{
            "69.87":"Get Talktime of Rs. 7.47. Validity : 0 Days. Talk time : 7.47",
            "139.74":"Get Talktime of Rs. 14.95. Validity : 0 Days. Talk time : 14.95",
            "706.92":"Get Talktime of Rs. 81.75. Validity : 0 Days. Talk time : 81.75",
            "3542.82":"Get Talktime of Rs. 423.73. Validity : 0 Days. Talk time : 423.73",
            "7085.64":"Get Talktime of Rs. 847.46. Validity : 0 Days. Talk time : 847.46",
            "35432.31":"Get Talktime of Rs. 4237.29. Validity : 0 Days. Talk time : 4237.29"
         },
         "localFixedAmountsPlanNames":{
            "10.00":"Topup Plan",
            "20.00":"Topup Plan",
            "100.00":"Topup Plan",
            "500.00":"Topup Plan",
            "1000.00":"Topup Plan",
            "5000.00":"Topup Plan"
         },
         "localFixedAmountsDescriptions":{
            "10.00":"Get Talktime of Rs. 7.47. Validity : 0 Days. Talk time : 7.47",
            "20.00":"Get Talktime of Rs. 14.95. Validity : 0 Days. Talk time : 14.95",
            "100.00":"Get Talktime of Rs. 81.75. Validity : 0 Days. Talk time : 81.75",
            "500.00":"Get Talktime of Rs. 423.73. Validity : 0 Days. Talk time : 423.73",
            "1000.00":"Get Talktime of Rs. 847.46. Validity : 0 Days. Talk time : 847.46",
            "5000.00":"Get Talktime of Rs. 4237.29. Validity : 0 Days. Talk time : 4237.29"
         }
      }
   ],
   "promotions":[
      
   ]
}

400 This response is gotten when an incorrect parameter is used to make a request

JSON

{
  "timeStamp":"2021-05-13 23:07:04",
  "message":"Could not retrieve/update resources at the moment, please try again later",
  "path":"/operators/1288",
  "errorCode":null,
  "infoLink":null,
  "details":[
    
  ]
}

401 This response is gotten when an incorrect or expired access token is used to make a request

JSON

{
  "timeStamp":"2021-05-12 07:17:42",
  "message":"Full authentication is required to access this resource",
  "path":"/operators/128",
  "errorCode":"INVALID_TOKEN",
  "infoLink":null,
  "details":[
    
  ]
}

404 This response is gotten when a request is made to an incorrect URL path

JSON

{
  "timestamp":"2021-05-13T23:15:31.837+0000",
  "status":404,
  "error":"Not Found",
  "message":"No message available",
  "path":"/operator/128"
}

Request samples

cURL

curl --location --request GET 'https://topups.reloadly.com/operators/128?suggestedAmounts=true&suggestedAmountsMap=true' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN_HERE' \
--header 'Accept: application/com.reloadly.topups-v1+json' 

C#

using System;
using System.Threading.Tasks;
using System.Net.Http;
using System.Text;
using Newtonsoft.Json;

namespace WebAPIClient {
  class Program {

    static async Task Main(string[] args) {
      await ApiCall();
    }

    private static async Task ApiCall() {

      var message = new HttpRequestMessage(HttpMethod.Get, "https://topups.reloadly.com/operators/128?suggestedAmounts=true&suggestedAmountsMap=true");

      message.Headers.TryAddWithoutValidation("Authorization", "Bearer YOUR_ACCESS_TOKEN_HERE");
      message.Headers.TryAddWithoutValidation("Accept", "application/com.reloadly.topups-v1+json");

      using
      var httpClient = new HttpClient();
      var response = await httpClient.SendAsync(message);
      var responseBody = await response.Content.ReadAsStringAsync();
      var result = JsonConvert.DeserializeObject < dynamic > (responseBody);

      Console.WriteLine(result);
    }

  }
}

Golang

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://topups.reloadly.com/operators/128?suggestedAmounts=true&suggestedAmountsMap=true"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Authorization", "Bearer YOUR_ACCESS_TOKEN_HERE")
  req.Header.Add("Accept", "application/com.reloadly.topups-v1+json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

Java

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
Request request = new Request.Builder()
  .url("https://topups.reloadly.com/operators/128?suggestedAmounts=true&suggestedAmountsMap=true")
  .method("GET", null)
  .addHeader("Authorization", "Bearer YOUR_ACCESS_TOKEN_HERE")
  .addHeader("Accept", "application/com.reloadly.topups-v1+json")
  .build();
Response response = client.newCall(request).execute();

Node JS

var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://topups.reloadly.com/operators/128?suggestedAmounts=true&suggestedAmountsMap=true',
  'headers': {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN_HERE',
    'Accept': 'application/com.reloadly.topups-v1+json'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://topups.reloadly.com/operators/128?suggestedAmounts=true&suggestedAmountsMap=true',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer YOUR_ACCESS_TOKEN_HERE',
    'Accept: application/com.reloadly.topups-v1+json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Python

import requests
import json

url = "https://topups.reloadly.com/operators/128?suggestedAmounts=true&suggestedAmountsMap=true"

payload={}
headers = {
  'Authorization': 'Bearer YOUR_ACCESS_TOKEN_HERE',
  'Accept': 'application/com.reloadly.topups-v1+json'
}

Response parameters

Parameter	Type	Description
id/operatorId	integer	This indicates the operator's ID
name	string	This indicates the operator's name
bundle	boolean	Indicates if the operator has any existing bundle plans
data	boolean	Indicates if the operator has any existing data plans
pin	boolean	Indicates if the operator supports PIN transactions
supports LocalAmounts	boolean	Indicates if the operator can make top-ups in local amounts
denominationType	string	Indicates if the operator makes top-ups through a fixed amount or a range of amounts. Options include FIXED and RANGE
senderCurrencyCode	string	Indicates the currency code of the account where the top-up is being made from
senderCurrency Symbol	string	Indicates the currency symbol of the account where the top-up is being made from
destination CurrencyCode	string	Indicates the currency code of the mobile number where the top-up is being sent to
destination CurrencySymbol	string	Indicates the currency symbol of the mobile number where the top-up is being sent to
commission	integer	Indicates if the operator offers a commission or discount
international Discount	integer	Indicates if the operator offers a discount for top-ups made to foreign numbers
localDiscount	integer	Indicates if the operator offers a discount for top-ups made to local numbers
mostPopularAmount	integer	Indicates the amount that is often used to make a top-up
mostPopular LocalAmount	integer	Indicates the amount that is often used to make a top-up locally
minAmount	integer	Indicates the minimum amount that can be used to make a top-up
maxAmount	integer	Indicates the maximum amount that can be used to make a top-up
localMinAmount	integer	Indicates the minimum amount that can be used to make a top-up locally
localMaxAmount	integer	Indicates the maximum amount that can be used to make a top-up locally
isoName	string	Indicates the country's ISO code
name	string	Indicates the country's name
rate	integer	Indicates the FX rate at which the top-up will be made
currencyCode	string	Indicates the code of the currency at which the top-up will be made
logoURLs	string	These are links to SVG images of the operator's logos
fixedAmounts	integer	Indicates the fixed amounts that a top-up can be made in with the operator
fixedAmounts Description	string	Indicates the descriptions for the operator's fixed amounts
localFixedAmounts	integer	Indicates the local fixed amounts that a top-up can be made in with the operator
localFixed AmountsDescription	string	Indicates the descriptions for the operator's local fixed amounts
suggestedAmounts	integer	Indicates the suggested amounts that can be used to make a top-up with the operator
suggested AmountsMap	string	Indicates the suggested amounts that can be mapped through
promotions	string	Indicates the promotions currently offered by the operator

Response parameters (for operators in India)

Parameter	Type	Description
geographical RechargePlans	object	Indicates an object that contains the details of each geographical plan owned by the operator within a country
locationCode	string	This is an abbreviation for the geographical location that has a different recharge plan. Examples include “AP” for “Andhra Pradesh” or “DEL” for “Delhi”
locationName	string	This is the name of a geographical location that has a different recharge plan
fixedAmounts	integer	Indicates the fixed amounts that a top-up can be made in with the operator
localAmounts	integer	Indicates the local amounts that a top-up can be made in with the operator
fixedAmounts PlanNames	string	Indicates the plan name (top-up, data, or bundle) for each fixed amount provided by the operator
fixedAmounts Descriptions	string	Indicates the plan description (top-up, data, or bundle) for each fixed amount provided by the operator
localFixedAmounts PlanNames	string	Indicates the plan name (top-up, data, or bundle) for each local fixed amount provided by the operator
localFixedAmounts PlanDescriptions	string	Indicates the plan description (top-up, data, or bundle) for each local fixed amount provided by the operator