API

Base URL: https://api.useclawfi.com/v1

Authentication

All API requests require authentication via Bearer token:

Authorization: Bearer YOUR_API_KEY

Rate Limits

• 1000 requests per minute per API key

• 10,000 requests per hour per API key

Rate limit headers are included in all responses:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1645564800

Endpoints

Vaults

Create Vault

POST /vaults

Request Body:

{
  "name": "Operating Account",
  "currency": "USD",
  "metadata": {
    "department": "engineering"
  }
}

Response:

{
  "id": "vault_1a2b3c4d",
  "name": "Operating Account",
  "currency": "USD",
  "balance": 0,
  "created_at": "2026-02-20T10:30:00Z",
  "metadata": {
    "department": "engineering"
  }
}

Get Vault

GET /vaults/:id

List Vaults

GET /vaults?limit=10&starting_after=vault_xyz

Query Parameters:

• limit (optional): Number of results (default: 10, max: 100)

• starting_after (optional): Cursor for pagination

• currency (optional): Filter by currency

Update Vault

PATCH /vaults/:id

Transactions

Create Transaction

POST /transactions

Request Body:

{
  "from_vault_id": "vault_123",
  "to_vault_id": "vault_456",
  "amount": 1000,
  "currency": "USD",
  "description": "Payment for services",
  "idempotency_key": "unique_key_123"
}

Get Transaction

GET /transactions/:id

List Transactions

GET /transactions?vault_id=vault_123&limit=50

Cards

Issue Card

POST /cards

Request Body:

{
  "vault_id": "vault_123",
  "type": "virtual",
  "spending_limits": {
    "daily": 500,
    "monthly": 5000
  }
}

Webhooks

See Webhooks Documentation for details on event subscriptions.

Errors

See Error Reference for complete error code documentation.