Developer API

Build with the
Vanton API

A powerful RESTful API to programmatically create cards, manage transactions, and automate your spend workflows.

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

Authentication

API key authentication

All API requests require authentication via an API key passed in the request header. Keys are scoped to your organization and can be rotated at any time from the dashboard.

1 Get your API key from the Vanton dashboard under Settings → API Keys.
2 Include the key in every request using the Authorization header.
3 Keep it secure. Never expose your key in client-side code or public repos.

bash

# Authenticate with your API key
curl https://api.vantocard.com/v1/cards \
  -H "Authorization: Bearer vk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json"
                    

Endpoints

Core API resources

Everything you need to manage cards, track transactions, and receive real-time updates via webhooks.

Cards

Create, manage, and control virtual cards programmatically.

POST /v1/cards
GET /v1/cards
POST /v1/cards/:id/freeze
PATCH /v1/cards/:id/limits

Transactions

Query transaction history, filter by card, and export data.

GET /v1/transactions
GET /v1/transactions/:id
POST /v1/transactions/export

Webhooks

Receive real-time notifications for card and transaction events.

POST /v1/webhooks
GET /v1/webhooks
DEL /v1/webhooks/:id

Quick Start

Create your first card

Issue a new virtual card with custom spending limits in a single API call. The card is instantly ready for use.

JSON request and response format
Idempotent operations with request IDs
Standard HTTP status codes
Pagination via cursor-based tokens
Comprehensive error messages

bash

# Create a new virtual card
curl -X POST https://api.vantocard.com/v1/cards \
  -H "Authorization: Bearer vk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Marketing SaaS",
    "type": "single_use",
    "currency": "USD",
    "spending_limit": {
      "amount": 5000,
      "interval": "monthly"
    },
    "metadata": {
      "department": "marketing",
      "cost_center": "CC-2040"
    }
  }'

# Response (201 Created)
# {
#   "id": "card_8xKj2mNpQr",
#   "name": "Marketing SaaS",
#   "last4": "4242",
#   "status": "active",
#   "spending_limit": {
#     "amount": 5000,
#     "interval": "monthly"
#   },
#   "created_at": "2026-09-14T06:12:00Z"
# }
                    

SDKs & Libraries

Official SDKs

Get up and running quickly with our official client libraries for popular languages.

Python

Python 3.8+ with async support

pip install vanton

Node.js

Node 16+ with TypeScript types

npm install @vanton/sdk

Go

Go 1.20+ module

go get vanton.dev/sdk

Java

Java 11+ with Maven/Gradle

com.vanton:sdk:1.0.0

Rate Limits

Generous rate limits

Built for production workloads. Need higher limits? Contact us for Enterprise plans.

1,000

requests / minute

Standard rate limit for all authenticated API endpoints.

100

cards / minute

Card creation rate limit to ensure processing reliability.

99.9%

uptime SLA

Our infrastructure is built for reliability with redundant systems.

Build with theVanton API