1. USD Virtual Cards
Numero Documentation
  • Overview
  • Transfers & Payouts
    • Validate Account Number
      POST
    • Initiate Single Transfer
      POST
    • Initiate Bulk Transfer
      POST
    • Transfer Status
      GET
  • Virtual Accounts
    • Create Virtual Account Customer
      POST
    • Create Virtual Account Business
      POST
    • Get Virtual Account
      GET
    • Get All Virtual Accounts
      GET
  • Virtual Cards
    • USD Virtual Cards
      • Issue Card
        POST
      • Top Up Card
        POST
      • Withdraw From Card
        POST
      • Activate Card
        POST
      • Deactivate Card
        POST
      • Get Card Transactions
        POST
      • Get Merchant Customers
        POST
      • Get Card Details
        POST
      • List Cards By Customer Id
        POST
  • Transaction History
    • Get Transactions
      GET
  • Webhooks & Security
    • Webhook Notifications
    • Generate Signature
      POST
  1. USD Virtual Cards

Get Card Details

POST
/api/v{{apiVersion}}/business/card/details
DTO: CardDetailsRequestDto — cardId, withPan (bool, default false).
Response: ApiResponse<GetCardDetailsResponse>.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'https://api-dev.usenumero.com/numeroaccount/api/v{{apiVersion}}/business/card/details' \
--header '{{headerApiKeyName}}: {{businessApiKey}}' \
--header '{{headerSignatureName}}: {{requestSignature}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "cardId": "CARD_ID_FROM_ISSUE_OR_LIST",
  "withPan": false
}'
Response Response Example
{
  "status": true,
  "message": "Success",
  "code": "00",
  "version": "v1",
  "reference": "N2026032512010007",
  "data": {
    "cardNumber": "411111******1111",
    "amountLimit": 100000,
    "usageLimit": 50,
    "limitWindow": "monthly",
    "expirationDate": "2028-12-31T00:00:00",
    "expiration": "12/28",
    "currencyCode": "NGN",
    "firstSix": "411111",
    "lastFour": "1111",
    "nameLine1": "JANE DOE",
    "nameLine2": null,
    "status": "active",
    "availableBalance": 15000.5,
    "isPhysical": false,
    "cardType": "virtual",
    "purchaseType": "debit"
  },
  "error": null
}
Modified at 2026-03-25 19:02:27
Previous
Get Merchant Customers
Next
List Cards By Customer Id
Built with