API Reference

REST API for creating, funding, and managing prepaid virtual cards. Base URL: https://api.clawdspend.com/v1

All requests require: Authorization: Bearer YOUR_API_KEY

POST /cards/create

Create a new prepaid virtual Visa card.

Request body

json

{
  "spending_limit": 100,
  "expiration_months": 12,
  "merchant_whitelist": ["5411", "7372"]
}

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"
}

POST /cards/fund

Add funds from your ClawdSpend balance to a card.

Request body

json

{
  "card_id": "card_72jdfk3",
  "amount": 50,
  "currency": "USD"
}

Response

json

{
  "card_id": "card_72jdfk3",
  "amount_added": 50,
  "currency": "USD",
  "new_balance": 50
}

POST /cards/lock

Lock a card so it can no longer be used. Reversible via unlock.

Request body

json

{
  "card_id": "card_72jdfk3"
}

GET /cards

List cards for your account. Supports pagination via limit and starting_after.

Response

json

{
  "data": [
    {
      "card_id": "card_72jdfk3",
      "number_masked": "•••• 4242",
      "expiry": "12/27",
      "spending_limit": 100,
      "balance": 50,
      "currency": "USD",
      "status": "active",
      "created_at": "2025-03-10T12:00:00Z"
    }
  ],
  "has_more": false
}

GET /transactions

List transactions. Filter by card_id to see spend for a single card.

Query params

text

?card_id=card_72jdfk3&limit=20&starting_after=txn_abc123

Response

json

{
  "data": [
    {
      "transaction_id": "txn_abc123",
      "card_id": "card_72jdfk3",
      "amount": -14.20,
      "currency": "USD",
      "merchant": "OpenAI",
      "status": "completed",
      "created_at": "2025-03-10T14:30:00Z"
    }
  ],
  "has_more": false
}

← Security Model Examples →