List Card Products - Numero

Returns the card products available to your business — each with its capabilities (the valid capability values at issue) and your entitlement status. Use this instead of hardcoding product codes. You can only issue from products with entitlementStatus: Approved.

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/products

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`.

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

Response

{
  "data": [
    {
      "code": "USD_VIRTUAL",
      "name": "USD Virtual Card",
      "currency": "USD",
      "capabilities": "USD",
      "setupFeeUsd": 2,
      "minFundingUsd": 5,
      "entitlementStatus": "Approved"
    },
    {
      "code": "USD_APPLE_PAY",
      "name": "USD Wallet Card",
      "currency": "USD",
      "capabilities": "USD,APPLE_PAY,GOOGLE_PAY",
      "setupFeeUsd": 2,
      "minFundingUsd": 5,
      "entitlementStatus": "Requested"
    }
  ],
  "error": null,
  "meta": {
    "request_id": "req_365123ebc73323f1482508560ce6400e",
    "pagination": null
  }
}