Creating Cards
Generate prepaid virtual Visa cards via the API. Each card can have spending limits, expiration, and optional merchant rules.
Create a card
Use POST /cards/create to create a new virtual card. The response includes the card number, expiry, and CVV—store these securely and pass them to your agent only through secure channels.
bash
curl -X POST https://api.clawdspend.com/v1/cards/create \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"spending_limit": 100,
"expiration_months": 12,
"merchant_whitelist": ["5411", "7372"]
}'Parameters
| Parameter | Type | Description |
|---|---|---|
| spending_limit | number | Maximum amount (in currency units) the card can spend. Required. |
| expiration_months | number | Card validity in months from creation. Default: 12. |
| merchant_whitelist | string[] | Optional MCC codes. If set, card can only be used at matching merchants. |
Example response
json
{
"card_id": "card_72jdfk3",
"number": "4242 4242 4242 4242",
"expiry": "12/27",
"cvv": "382",
"spending_limit": 100,
"currency": "USD",
"created_at": "2025-03-10T12:00:00Z"
}