Authentication
Include your API key in every request:
# Header
Authorization: Bearer sk_live_your_key_here
Get your key at clawd.cards
1. Create a Card
POSTRequest a virtual card for a purchase.
POST /cardscurl -X POST https://api.clawd.cards/v1/cards \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"amount": 20.00,
"reason": "Vercel Pro hosting",
"merchant_category": "web_hosting"
}'
Response:
{
"card": {
"number": "4111111111111111",
"cvv": "123",
"expiry": "12/26",
"expires_at": "2026-02-16T15:00:00Z"
},
"transaction_id": "txn_abc123"
}
Parameters:
amount- Dollar amount (max $100)reason- Why you need this card (min 10 chars)merchant_category- Type:web_hosting, cloud_compute, api_services, saas_tools, domains, databases, other
Card expires in 1 hour or after use.
2. Check Limits
GETSee how much you can spend.
GET /limitscurl https://api.clawd.cards/v1/limits \
-H "Authorization: Bearer sk_live_..."
Response:
{
"monthly_limit": 50000,
"monthly_spent": 12000,
"monthly_remaining": 38000,
"per_transaction_limit": 10000
}
All amounts in cents. 50000 = $500.00
3. List Transactions
GETView your purchase history.
GET /transactionscurl https://api.clawd.cards/v1/transactions \
-H "Authorization: Bearer sk_live_..."
Response:
{
"transactions": [
{
"id": "txn_abc123",
"amount": 2000,
"merchant_name": "Vercel Inc.",
"reason": "Vercel Pro hosting",
"success": true,
"created_at": "2026-02-16T14:23:45Z"
}
]
}
Quick Examples
Node.js
// Create a card
const response = await fetch('https://api.clawd.cards/v1/cards', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.CLAWDCARDS_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
amount: 20.00,
reason: 'Railway deployment',
merchant_category: 'cloud_compute'
})
});
const { card } = await response.json();
Python
import requests
import os
# Create a card
response = requests.post(
'https://api.clawd.cards/v1/cards',
headers={'Authorization': f'Bearer {os.getenv("CLAWDCARDS_API_KEY")}'},
json={
'amount': 20.00,
'reason': 'Railway deployment',
'merchant_category': 'cloud_compute'
}
)
Errors
| Status | Meaning |
|---|---|
| 400 | Invalid parameters |
| 401 | Invalid API key |
| 403 | Spending limit exceeded |
| 429 | Rate limit (10 req/min) |
| 503 | No cards available (beta) |