Skip to main content
POST
Preview an eligible Numero service fee

Authorizations

X-Numero-Api-Key
string
header
required

Your business API key (live_key_...). Issued on approval; managed in Dashboard β†’ Settings β†’ Developer.

X-Numero-Signature
string
header
required

Base64(HMAC-SHA256(publicApiKey, input)) over the raw request body (POST) or canonicalized query string (signed GET). Also send X-Numero-Signature-Version: v2. Required on money-movement / state-changing endpoints (marked πŸ”’).

The HMAC key is your Public Key as raw UTF-8 bytes β€” a SECRET despite the name, and a different value from the X-Numero-Api-Key authentication header. Signing with the API key will never produce a valid signature.

Headers

X-Numero-Signature
string
required

Body

application/json
serviceCode
enum<string>
required
Available options:
FTXFR,
INTXFR,
AIRTIME,
DATA,
CABLETV,
ELECTRICITY,
BETTING,
GLOBALAIRTIME,
GLOBALDATA,
GIFTCARD,
UTILITY
currency
enum<string>
required
Available options:
NGN,
GBP
amount
number
required

Response

Fee-only preview in major currency units.

status
boolean
data
object