COLLECTIONS

Quote a collection

POSThttps://production.dutchapi.co/v1/collections/quote

Returns the Dutch API fee for a mobile money collection, the amount that lands in your wallet, and the currently available amount range.

🔒Send the project API key as a Bearer token and your Business ID with this call.

Body Params

amountnumberrequired

Amount the payer will be asked to approve, in the local currency.

currencystringrequired

Local currency, for example XAF.

countrystringoptional

ISO country code. Defaults to the country of the currency.

markupPercentnumberoptional

Your markup, percent of the amount.

markupFixednumberoptional

Your fixed markup in the request currency.

Responses

{
  "amount": 10000,
  "currency": "XAF",
  "fees": {
    "currency": "XAF",
    "rule": "percentage",
    "ruleDetail": "2% of the amount",
    "dutchFee": 200,
    "markup": 100,
    "totalFee": 300
  },
  "you_receive": 9800,
  "min": 500,
  "max": 500000,
  "indicative": true
}

{
  "error": "valid_amount_required",
  "message": "amount must be a positive number."
}

Errors

Status	error	Meaning
400	`valid_amount_required`	amount must be a positive number.
422	`collection_not_priced`	There is no published collection rate for that country or method.
422	`amount_below_minimum`	The amount is under the published minimum.

Updated 2026

Did this page help you?

PreviousRetrieve a payout NextCreate a collection

Language

CredentialsBearer

curl --request POST --url "https://production.dutchapi.co/v1/collections/quote" \
  --header "Authorization: Bearer $DUTCH_PROJECT_KEY" \
  --header "X-Business-Id: $DUTCH_BUSINESS_ID" \
  --header "Content-Type: application/json" \
  --data '{"amount":10000,"currency":"XAF","markupPercent":1}'

const res = await fetch("https://production.dutchapi.co/v1/collections/quote", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.DUTCH_PROJECT_KEY,
    "X-Business-Id": process.env.DUTCH_BUSINESS_ID,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"amount": 10000, "currency": "XAF", "markupPercent": 1})
});
console.log(await res.json());

require "net/http"
require "json"

uri = URI("https://production.dutchapi.co/v1/collections/quote")
req = Net::HTTP::Post.new(uri)
req["Authorization"] = "Bearer #{ENV.fetch('DUTCH_PROJECT_KEY')}"
req["X-Business-Id"] = ENV.fetch("DUTCH_BUSINESS_ID")
req["Content-Type"] = "application/json"
req.body = "{\"amount\":10000,\"currency\":\"XAF\",\"markupPercent\":1}"
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
puts res.body

<?php
$ch = curl_init("https://production.dutchapi.co/v1/collections/quote");
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("DUTCH_PROJECT_KEY"),
    "X-Business-Id: " . getenv("DUTCH_BUSINESS_ID"),
    "Content-Type: application/json"],
  CURLOPT_POSTFIELDS => '{"amount":10000,"currency":"XAF","markupPercent":1}',
]);
echo curl_exec($ch);

import os, requests, json

res = requests.request(
    "POST",
    "https://production.dutchapi.co/v1/collections/quote",
    headers={
        "Authorization": "Bearer " + os.environ["DUTCH_PROJECT_KEY"],
        "X-Business-Id": os.environ["DUTCH_BUSINESS_ID"],
    },
    json=json.loads("{\"amount\":10000,\"currency\":\"XAF\",\"markupPercent\":1}")
)
print(res.json())

Response

Click `Show example` to see an example response. Nothing is sent from this page: endpoints are live, so run real requests from your own code with small amounts.