Check Transaction Limits

When to use this

Use this once you know the corridor and amount, before quoting or executing.

Request

curl --request POST \
  --url $baseUrl/transactions/limits \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'x-idempotency-key: YOUR_UNIQUE_UUID' \
  --data '{
    "currency": "USD",
    "country": "NG",
    "rail": "bank_transfer"
  }'

Response

Returns the minimum amount, maximum amount, and any daily limit for the requested corridor.

Validate before executing

transaction_amount >= minimum_amount
transaction_amount <= maximum_amount
daily_volume + transaction_amount <= daily_limit

Surface a clear error to the user if the amount falls outside these bounds — don't let it fail at execution time instead.

Limits can change. Fetch them fresh per session rather than hardcoding them in your application.

Common failure reasons

• The corridor isn't supported for the currency/country pair
• The rail value is invalid for the transaction
• No matching limit configuration exists

Call this next

• Get Supported Networks
• Generate Quote