Get Card

Returns a single card by its reference, masked. balance is the amount currently available to spend on the card, separate from the business USD card-wallet balance. This response does not contain the full card number or CVV; use the explicit Reveal Card Details endpoint when the cardholder needs them. Test and live API keys use the same base URL, https://api.usenumero.com/numeroaccount/api/v1. A test_key_ returns isolated simulated card data; a live key reads the business’s live cards. Use a reference from the matching mode. nameOnCard is the exact issuer-returned card name, which can differ from the customer’s full legal name. label remains the separate merchant-defined label. billingAddress contains address, city, state, postalCode and country when supplied by the issuer; use this address for card billing, not the cardholder’s residential address. Missing metadata is returned as null, not guessed. Opening an existing card refreshes issuer metadata, which is then available in card-list responses too.

Card endpoints use the same base URL and API key as the rest of the API, and are signature-gated: send X-Numero-Signature and X-Numero-Signature-Version: v2 as well. See Request signing.

Endpoint

GET /api/v1/business/card/{reference}

Signature required: Yes

Headers

Header	Required	Description
`X-Numero-Api-Key`	Yes	Your API key
`X-Numero-Signature`	Yes	Base64 HMAC-SHA256 over the exact raw request body (POST) or the canonicalised query string (GET), keyed with your Public Key. See Request signing.
`X-Numero-Signature-Version`	Yes	Always `v2`.

Path parameters

Parameter	Type	Required	Description
`reference`	string	Yes	The card reference

Request example

curl -X GET "https://api.usenumero.com/numeroaccount/api/v1/business/card/NCRD24AD18BEBD474A" \
  -H "X-Numero-Api-Key: your_api_key" \
  -H "X-Numero-Signature: $SIGNATURE" \
  -H "X-Numero-Signature-Version: v2"

Response

{
  "data": {
    "cardReference": "NCRD24AD18BEBD474A",
    "customerId": "NCUS9953596C2B7F45",
    "label": "Ads spend",
    "nameOnCard": "ADA OBI",
    "billingAddress": null,
    "brand": "Visa",
    "firstSix": "428852",
    "lastFour": "6353",
    "expiryMonth": "06",
    "expiryYear": "2029",
    "currency": "USD",
    "balance": 25.0,
    "status": "Active",
    "isPhysical": false,
    "dailyLimit": 5000,
    "perTransactionLimit": 1000,
    "issuedAt": "2026-06-16T12:00:00Z",
    "capabilities": [
      "USD",
      "APPLE_PAY",
      "GOOGLE_PAY"
    ]
  },
  "error": null,
  "meta": {
    "request_id": "req_365123ebc73323f1482508560ce6400e",
    "pagination": null
  }
}

Card statuses

Status	Description
`Pending`	Created, not yet active
`Active`	Usable
`Frozen`	Temporarily blocked (reversible)
`Terminated`	Permanently closed

Getting Started

Transfers & Payouts

Collections (Virtual Accounts)

Wallet-as-a-Service

Customers

Invoices

Cards

Cardholders

Balance & Transactions

Value Added Services

Credit

Verification / KYC

Webhooks

Endpoint

Headers

Path parameters

Request example

Response

Card statuses

​Endpoint

​Headers

​Path parameters

​Request example

​Response

​Card statuses

Endpoint

Headers

Path parameters

Request example

Response

Card statuses