Skip to main content
Returns all cards your business has issued, masked. Supports pagination.
Card endpoints use the same base URL and API key as the rest of the API and are not signature-gated.

​
Endpoint

GET /api/v1/business/card
Signature required: No

​
Headers

HeaderRequiredDescription
X-Numero-Api-KeyYesYour API key

​
Query parameters

ParameterTypeRequiredDescription
pageNumberintegerNoPage number (default 1)
pageSizeintegerNoPage size (default 50, max 200)

​
Request example

curl -X GET "https://api-dev.usenumero.com/numeroaccount/api/v1/business/card?pageNumber=1&pageSize=50" \
  -H "X-Numero-Api-Key: your_api_key"

​
Response

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "version": "v1",
  "reference": "N20260616120000",
  "data": [{
    "cardReference": "NCRD24AD18BEBD474A",
    "customerId": "NCUS9953596C2B7F45",
    "label": "Ads spend",
    "brand": "Visa",
    "firstSix": "428852",
    "lastFour": "6353",
    "expiryMonth": "06",
    "expiryYear": "2029",
    "currency": "USD",
    "balance": 25.00,
    "status": "Active",
    "isPhysical": false,
    "dailyLimit": 5000,
    "perTransactionLimit": 1000,
    "issuedAt": "2026-06-16T12:00:00Z",
    "capabilities": ["USD", "APPLE_PAY", "GOOGLE_PAY"]
  }],
  "error": null
}