Skip to main content
Calculate fees for a bulk transfer. Returns the total fees and a per-item breakdown.

​
Endpoint

POST /api/v1/business/fee/bulk
Signature required: Yes

​
Headers

HeaderRequiredDescription
x-api-keyYesYour API key
x-signature-keyYesRequest signature

​
Request body

FieldTypeRequiredDescription
transferItemsarrayYesArray of items, each with an amount field

​
Transfer item object

FieldTypeRequiredDescription
amountnumberYesTransfer amount in Naira

​
Request example

curl -X POST "https://api-dev.usenumero.com/numeroaccount/api/v1/business/fee/bulk" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key" \
  -H "x-signature-key: generated_signature" \
  -d '{
    "transferItems": [
      { "amount": 150000 },
      { "amount": 200000 }
    ]
  }'

​
Response

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "version": "v1",
  "reference": "abc123",
  "data": {
    "totalAmount": 350000.00,
    "totalNumeroFee": 30.00,
    "totalStampDuty": 100.00,
    "totalFee": 130.00,
    "totalDeductible": 350130.00,
    "feeBreakdown": [
      {
        "amount": 150000.00,
        "numeroFee": 15.00,
        "stampDuty": 50.00,
        "totalFee": 65.00
      },
      {
        "amount": 200000.00,
        "numeroFee": 15.00,
        "stampDuty": 50.00,
        "totalFee": 65.00
      }
    ]
  },
  "error": null
}
FieldTypeDescription
totalAmountnumberSum of all transfer amounts
totalNumeroFeenumberTotal of the fees you’re charged
totalStampDutynumberTotal NGN stamp duty (government levy, not a Numero fee)
totalFeenumberGrand total (totalNumeroFee + totalStampDuty)
totalDeductiblenumberTotal that will be deducted from your balance
feeBreakdownarrayPer-item fee breakdown