Skip to main content
Returns the full card number, CVV and expiry, fetched live from the issuer. Sensitive — Numero never stores the full PAN. Only call this from a PCI-aware context and never log the response.
Card endpoints use the same base URL and API key as the rest of the API and are not signature-gated.

​
Endpoint

POST /api/v1/business/card/{reference}/reveal
Signature required: No

​
Headers

HeaderRequiredDescription
X-Numero-Api-KeyYesYour API key

​
Path parameters

ParameterTypeRequiredDescription
referencestringYesThe card reference

​
Request example

curl -X POST "https://api-dev.usenumero.com/numeroaccount/api/v1/business/card/NCRD24AD18BEBD474A/reveal" \
  -H "X-Numero-Api-Key: your_api_key"

​
Response

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "version": "v1",
  "reference": "N20260616120000",
  "data": {
    "cardReference": "NCRD24AD18BEBD474A",
    "pan": "4288520000006353",
    "cvv": "123",
    "expiryMonth": "06",
    "expiryYear": "2029",
    "cardholderName": "Ada Obi"
  },
  "error": null
}