List Cards By Customer Id

POST

/api/v{{apiVersion}}/business/card/list

DTO: ListCardsRequestDto — customerId (maps to cardCustomerId from issue response).

Response: ApiResponse<ListCardsResponse>.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://api-dev.usenumero.com/numeroaccount/api/v{{apiVersion}}/business/card/list' \
--header '{{headerApiKeyName}}: {{businessApiKey}}' \
--header '{{headerSignatureName}}: {{requestSignature}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "customerId": "CARD_CUSTOMER_ID_FROM_ISSUE"
}'

Response Example

{
  "status": true,
  "message": "Success",
  "code": "00",
  "version": "v1",
  "reference": "N2026032512010009",
  "data": {
    "cards": [
      {
        "id": "card_mid_abc123",
        "amount": "15000.50",
        "created_at": "2026-03-20T14:00:00",
        "currency": "NGN",
        "status": "active",
        "title": "Business card",
        "notes": null,
        "info": {
          "masked_pan": "411111******1111",
          "last4": "1111",
          "brand": "VISA",
          "type": "debit",
          "name_on_card": "JANE DOE"
        }
      }
    ]
  },
  "error": null
}

Modified at 2026-03-25 19:02:29

Get Card Details

Transaction History