Skip to main content
POST
/
business
/
cardholders
/
{customerId}
/
cards
Issue a card to a cardholder
curl --request POST \
  --url https://api-staging.usenumero.com/numeroaccount/api/v1/business/cardholders/{customerId}/cards \
  --header 'Content-Type: application/json' \
  --header 'X-Numero-Api-Key: <api-key>' \
  --data '
{
  "productCode": "USD_VIRTUAL",
  "capability": "APPLE_PAY",
  "label": "<string>",
  "initialBalance": 5,
  "brand": "visa"
}
'
{ "data": { "cardReference": "NCRD24AD18BEBD474A", "customerId": "NCUS9953596C2B7F45", "label": "<string>", "brand": "Visa", "firstSix": "428852", "lastFour": "6353", "expiryMonth": "06", "expiryYear": "2029", "currency": "USD", "balance": 5, "isPhysical": true, "dailyLimit": 123, "perTransactionLimit": 123, "issuedAt": "2023-11-07T05:31:56Z", "capabilities": [ "USD", "APPLE_PAY", "GOOGLE_PAY" ] }, "error": { "message": "<string>", "param": "<string>" }, "meta": { "request_id": "<string>", "pagination": { "page": 123, "page_size": 123, "total": 123, "has_more": true } } }

Authorizations

​
X-Numero-Api-Key
string
header
required

Your business API key (live_key_...). Issued on approval; managed in Dashboard → Settings → Developer.

Path Parameters

​
customerId
string
required

Body

application/json
​
productCode
string
Example:

"USD_VIRTUAL"

​
capability
enum<string> | null

Card type — omit/USD for a plain card, APPLE_PAY/GOOGLE_PAY for a wallet-enabled card.

Available options:
USD,
APPLE_PAY,
GOOGLE_PAY,
null
Example:

"APPLE_PAY"

​
label
string | null
​
initialBalance
number
Example:

5

​
brand
string | null
Example:

"visa"

Response

The card (masked only)

Canonical response envelope for the public surface. data on success, error on failure.

​
data
object
required

A card as exposed to you — masked only.

​
error
object
required
​
meta
object
required