Pricing and Billing

Understand endpoint prices, billable outcomes, and wallet behavior.

Prices are denominated in Nigerian naira (NGN). The amount displayed in a response's billing object is also in naira.

Current pricing

VerificationEndpointPrice
NIN VerificationPOST /v1/verifications/nin₦100
NIN Verification by PhonePOST /v1/verifications/nin/phone₦120
BVN VerificationPOST /v1/verifications/bvn₦110
BVN Verification by PhonePOST /v1/verifications/bvn/phone₦100
Wallet BalanceGET /v1/balanceFree

When a request is charged

A live verification is charged when the lookup completes:

OutcomeCharged?
SUCCESSFULYes
NOT_FOUNDYes
SUSPENDEDYes
BLOCKEDYes
Validation or authentication errorNo
Insufficient balanceNo
Rate limitedNo
Service unavailable or internal errorNo
Test Sandbox responseNo

Completed negative outcomes are charged because the request was processed and returned a definitive result.

Billing object

{
  "billing": {
    "amount": 100,
    "currency": "NGN",
    "unit": "naira",
    "charged": true,
    "note": "Wallet charged 100.00 NGN"
  }
}

On an uncharged verification response, charged is false and note is No charges.

Wallet balance

Check the wallet before live traffic:

curl "https://api.idyntic.getapexly.com/v1/balance" \
  -H "Authorization: Bearer id_live_your_key"

Balance values are returned in naira, not kobo.


Did this page help you?