Filter Operators by Airtime vs. Data & Bundles via the API

When you fetch mobile operators from the Reloadly API, the default response includes every available service — airtime, data, and bundles — in a single payload.

The same physical carrier often has different operator IDs depending on the service. MTN Nigeria Airtime, for example, has a different operator ID than MTN Nigeria Data. If your application mixes them up, the customer may be charged for the wrong product.

Filtering your operator queries at the request level ensures you only display — and only charge for — the exact product your customer wants. Below you’ll find both filters, globally and for a specific country (Nigeria, NG, in the examples).

If your app has a dedicated Data Plans or Bundles screen, you don’t want standard airtime options cluttering the response. Restrict your GET request with two boolean query parameters:

• dataOnly=true — returns only operators that support raw mobile data recharges.
• bundlesOnly=true — returns only operators offering usage bundles (e.g., social media packs, weekly plans).

Global request

Country-specific request (Nigeria)

There is no direct airtimeOnly parameter. Instead, isolate standard airtime operators by excluding data, bundle, and combo products from the response with three parameters:

• includeData=false — hides all data-specific operator listings.
• includeBundles=false — hides promotional or restricted usage bundles.
• includeCombo=false — hides hybrid voice + data combo packages.

Global request

Country-specific request (Nigeria)

Filter parameters — quick reference

Use this table to construct your request URLs depending on which product catalog you want to display:

Parameter	Values	Default	What it does
dataOnly	true / false	false	Set to true to return only data-enabled operator profiles.
bundlesOnly	true / false	false	Set to true to return only bundle-enabled operator profiles.
includeData	true / false	true	Set to false to exclude data-specific operator listings.
includeBundles	true / false	true	Set to false to exclude bundle-specific operator listings.
includeCombo	true / false	true	Set to false to exclude combo (voice + data) packages.