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

{
  "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":[
    
  ]

{
   "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":[
      
   ]
}

{
  "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":[
    
  ]
}

{
  "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":[
    
  ]
}

Request samples

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'

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);
    }

  }
}

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))
}

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();

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

$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;

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

PreviousGet all operators NextAuto-detect an operator

Last updated 4 years ago

hashtagOperator by ID

hashtagPath Parameters

hashtagQuery Parameters

hashtagHeaders

hashtag

hashtagRequest samples

hashtagResponse parameters

hashtagResponse parameters (for operators in India)

Operator by ID

Path Parameters

Query Parameters

Headers

Request samples

Response parameters

Response parameters (for operators in India)