How can I determine the operator minimum and maximum amount /values.

Developers · Operators API

Every operator's valid amounts, straight from one endpoint

How to read the min/max and fixed-amount fields the /operators endpoint returns, depending on the denomination type.

Endpoint

/operators

Denomination types

Range or Fixed

Level

Technical

When you query the /operators endpoint, the response tells you exactly which amounts are valid for that operator. Operators fall into one of two denomination types — Range (also called Open Range) or Fixed — and which fields you should read depends on which type you're dealing with.

Range (Open Range) denominations

For operators with a range, you can send any amount between a minimum and a maximum — not just preset values. Four fields tell you that range:

Field	What it tells you
minAmount	Minimum amount, in your account's base currency
maxAmount	Maximum amount, in your account's base currency
localMinAmount	Minimum amount, in the operator's local currency
localMaxAmount	Maximum amount, in the operator's local currency

Fixed denominations

For operators with fixed denominations, you can only send one of a specific set of preset amounts — there's no free-form range.

Important: for fixed denominations, minAmount, maxAmount, localMinAmount, and localMaxAmount all return null. Don't rely on those fields for this denomination type.

Instead, the valid amounts live in these three fields:

Field	What it tells you
fixedAmounts	Array of valid amounts, in your account's base currency
localFixedAmounts	Array of valid amounts, in the operator's local currency
suggestedAmountsMap	A map pairing each fixed amount with its suggested/equivalent value

⚙️ How to use this in practice

Check minAmount first: if it's null, you're dealing with a fixed-denomination operator — read fixedAmounts instead. If it has a real value, you're dealing with a range — any amount between minAmount and maxAmount is valid.

Need help parsing a specific operator's response?

Our support team can walk through it with you.

Contact support →