Get All Operators ( by country and categories)

LedgerBlock provides access to financial and utility services across 54 countries, allowing businesses to integrate multiple services through a single API.

This Endpoint Retrieves a list of all available operators, including their country, currency, supported product types, and available products.

Request

Method: GET

Endpoint:

{{base_url}}/api/v1/utility/operators

Authentication & Headers

Header	Type	Required	Description
`Authorization`	String	Yes	`Bearer ${api_key}` — your activated merchant API key.
`x-merchant-ref`	String	Yes	Your unique merchant reference.

Response

Success Response

{
  "status": "success",
  "message": "Fetched",
  "data": {
    "data": [
      {
        "brandId": "3",
        "brandName": "Afghan Wireless",
        "country": "AF",
        "currency": "AFN",
        "id": "39",
        "name": "Afghanistan Afghan Wireless",
        "productTypes": ["1"],
        "products": [
          {
            "amount": {
              "max": {
                "operator": "5000.00",
                "user": "90.28"
              },
              "min": {
                "operator": "50.00",
                "user": "0.91"
              },
              "type": "range"
            },
            "category": "1.0",
            "extraParameters": null,
            "id": "6362",
            "name": "50-5000 AFN Top Up",
            "type": "1"
          }
        ]
      }
    ]
  }
}

Response Fields

Field	Type	Description
`status`	String	Indicates whether the request was successful.
`message`	String	Response message.
`data.data`	Array	List of available operators.
`brandId`	String	Unique identifier for the operator's brand.
`brandName`	String	Name of the operator's brand.
`country`	String	ISO country code.
`currency`	String	Currency code used by the operator.
`id`	String	Unique operator identifier.
`name`	String	Name of the operator.
`productTypes`	Array	Product types supported by the operator.
`products`	Array	Products available for the operator.
`products.id`	String	Unique product identifier.
`products.name`	String	Name of the product.
`products.type`	String	Product type identifier.
`products.category`	String	Product category.
`products.extraParameters`	Object/Null	Additional parameters required by the product, if any.
`products.amount`	Object	Defines the amount configuration for the product.
`amount.type`	String	Indicates whether the amount is fixed or range-based.
`amount.min.operator`	String	Minimum amount accepted by the operator.
`amount.max.operator`	String	Maximum amount accepted by the operator.
`amount.min.user`	String	Minimum amount the user can enter.
`amount.max.user`	String	Maximum amount the user can enter.


Yes—**I’d use this same “Authentication & Headers” format across the LedgerBlock documentation** so every endpoint is consistent.