Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Temporarily block or re-enable a card.
Card endpoints use the same base URL and API key as the rest of the API, and are signature-gated: sendX-Numero-SignatureandX-Numero-Signature-Version: v2as well. See Request signing.
POST /api/v1/business/card/{reference}/freeze
| 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. |
| Parameter | Type | Required | Description |
|---|---|---|---|
reference | string | Yes | The card reference |
curl -X POST "https://api.usenumero.com/numeroaccount/api/v1/business/card/NCRD24AD18BEBD474A/freeze" \
-H "X-Numero-Api-Key: your_api_key" \
-H "X-Numero-Signature: $SIGNATURE" \
-H "X-Numero-Signature-Version: v2"
POST /api/v1/business/card/{reference}/unfreeze
curl -X POST "https://api.usenumero.com/numeroaccount/api/v1/business/card/NCRD24AD18BEBD474A/unfreeze" \
-H "X-Numero-Api-Key: your_api_key" \
-H "X-Numero-Signature: $SIGNATURE" \
-H "X-Numero-Signature-Version: v2"
status (Frozen or Active).
{
"data": {
"cardReference": "NCRD24AD18BEBD474A",
"customerId": "NCUS9953596C2B7F45",
"label": "Ads spend",
"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
}
}