Skip to main content
POST
/
v1
/
bulk
/
quote
Create Bulk Quote
const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    paymentChannel: 'BANK_TRANSFER',
    items: [{sourceAmount: 100}, {sourceAmount: 250.5}],
    source: {currency: 'NGN', country: 'NG'},
    target: {currency: 'NGN', country: 'NG'}
  })
};

fetch('https://sandboxapi.me-cash.com/v1/bulk/quote', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "message": "bulk quote created successfully",
  "status": "success",
  "data": {
    "quotes": [
      {
        "quoteId": "fa01c1ad-6c0f-4074-8221-ffc8fdaa16db",
        "sourceAmount": 100,
        "targetAmount": 100,
        "rate": 1,
        "fee": 5,
        "sourceCurrency": "NGN",
        "targetCurrency": "NGN",
        "expiresInSeconds": 600
      },
      {
        "quoteId": "6809b2ab-1d4d-4436-8218-46667419eee7",
        "sourceAmount": 250.5,
        "targetAmount": 250.5,
        "rate": 1,
        "fee": 5,
        "sourceCurrency": "NGN",
        "targetCurrency": "NGN",
        "expiresInSeconds": 600
      }
    ]
  }
}

​
Error responses

StatusMessageWhat it meansHow to fix
400Invalid country or currency ISO codeSource/target country or currency combination is unsupported.Send ISO pairs for corridors enabled on your workspace.
400Invalid Payment Channel, check docs or contact supportpaymentChannel is not valid for the corridor.Switch to a supported channel for the requested route.
400Required field missing or invalid requestPayload is missing mandatory attributes.Validate source, target, paymentChannel, and items before calling.
401API key missing or incorrectx-api-key header missing/invalid.Include the correct API key for sandbox/production.
403Access denied: IP address not whitelistedIP address has not been whitelisted.Add your server IP in the dashboard.
429API rate limit exceededToo many requests in a short window.Implement exponential backoff before retrying.
500Service temporarily unavailableTemporary backend outage or maintenance.Retry shortly and escalate if it continues.

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
paymentChannel
enum<string>
required

The channel through which the payments will be processed.

Available options:
BANK_TRANSFER,
INTERAC,
SWIFT,
MOBILE_MONEY
Example:

"BANK_TRANSFER"

​
items
object[]
required

List of individual transfer amounts to quote.

​
source
object
required

Source currency and country.

​
target
object
required

Target currency and country.

Response

Bulk quote created successfully.

​
message
string
Example:

"bulk quote created successfully"

​
status
string
Example:

"success"

​
data
object