Skip to main content
Returns a single card by its reference, masked. The balance shown is Numero’s mirrored figure.
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/{reference}
Signature required: No

Headers

HeaderRequiredDescription
X-Numero-Api-KeyYesYour API key

Path parameters

ParameterTypeRequiredDescription
referencestringYesThe card reference

Request example

curl -X GET "https://api-dev.usenumero.com/numeroaccount/api/v1/business/card/NCRD24AD18BEBD474A" \
  -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
}

Card statuses

StatusDescription
PendingCreated, not yet active
ActiveUsable
FrozenTemporarily blocked (reversible)
TerminatedPermanently closed