Endpoint
POST /api/v1/business/fee/bulk
Headers
| Header | Required | Description |
|---|---|---|
X-Numero-Api-Key | Yes | Your API key |
X-Numero-Signature | Yes | Base64 HMAC-SHA256 over the exact raw request body (POST) or the canonicalised query string (GET), keyed with your Public Key. See Request signing. |
X-Numero-Signature-Version | Yes | Always v2. |
Request body
| Field | Type | Required | Description |
|---|---|---|---|
transferItems | array | Yes | Array of items, each with an amount field |
Transfer item object
| Field | Type | Required | Description |
|---|---|---|---|
amount | number | Yes | Transfer amount in Naira |
Request example
curl -X POST "https://api.usenumero.com/numeroaccount/api/v1/business/fee/bulk" \
-H "Content-Type: application/json" \
-H "X-Numero-Api-Key: your_api_key" \
-H "X-Numero-Signature: $SIGNATURE" \
-H "X-Numero-Signature-Version: v2" \
-d '{
"transferItems": [
{ "amount": 150000 },
{ "amount": 200000 }
]
}'
Response
{
"data": {
"totalAmount": 350000.0,
"totalNumeroFee": 30.0,
"totalStampDuty": 100.0,
"totalFee": 130.0,
"totalDeductible": 350130.0,
"feeBreakdown": [
{
"amount": 150000.0,
"numeroFee": 15.0,
"stampDuty": 50.0,
"totalFee": 65.0
},
{
"amount": 200000.0,
"numeroFee": 15.0,
"stampDuty": 50.0,
"totalFee": 65.0
}
]
},
"error": null,
"meta": {
"request_id": "req_365123ebc73323f1482508560ce6400e",
"pagination": null
}
}
| Field | Type | Description |
|---|---|---|
totalAmount | number | Sum of all transfer amounts |
totalNumeroFee | number | Total of the fees you’re charged |
totalStampDuty | number | Total NGN stamp duty (government levy, not a Numero fee) |
totalFee | number | Grand total (totalNumeroFee + totalStampDuty) |
totalDeductible | number | Total that will be deducted from your balance |
feeBreakdown | array | Per-item fee breakdown |