Vault API v1.0.0

Multi-currency wallets on a double-entry ledger. Amounts are integers in minor units (cents) in responses; requests accept decimal strings.

Base URL https://vault.fabiancollado.net · Auth Authorization: Bearer vlt_… · Money integer cents

Auth

POST/api/v1/auth/registerCreate a customer and get a token
{
    "name": "Ada Lovelace",
    "email": "ada@example.com",
    "password": "correct horse battery"
}

Responses: 201 · 422

POST/api/v1/auth/tokenExchange credentials (and OTP when 2FA is on) for a Bearer token
{
    "email": "alex@vault.demo",
    "password": "vault-demo-2026",
    "otp": "123456"
}

Responses: 201 · 401

DELETE/api/v1/auth/tokenRevoke the current token🔒

Responses: 204

Account

GET/api/v1/meCurrent customer🔒

Responses: 200 · 401 · 422

GET/api/v1/accountsWallets and balances🔒

Responses: 200 · 401 · 422

GET/api/v1/transactionsLedger lines for the customer🔒
currency (query) USD | EUR | GBP
category (query) groceries, dining, …
q (query) Search description
page (query) Page (1-based)
limit (query) 1-100

Responses: 200 · 401 · 422

GET/api/v1/insightsSpending by category and balance history🔒
days (query) 7 | 30 | 90

Responses: 200 · 401 · 422

FX

GET/api/v1/ratesMid-market rates and fee

Responses: 200 · 401 · 422

GET/api/v1/quotesQuote an exchange
from (query) USD
to (query) EUR
amount (query) 100.00

Responses: 200 · 401 · 422

Money movement

POST/api/v1/transfersSend money to another customer🔒
Idempotency-Key (header, required) Unique key per logical operation. Replays return the original response with `Idempotent-Replayed: true`.
{
    "to_email": "sam@vault.demo",
    "currency": "USD",
    "amount": "25.00",
    "note": "Lunch 🍕"
}

Responses: 201 · 400 · 409 · 422

POST/api/v1/exchangesConvert between your own wallets🔒
Idempotency-Key (header, required) Unique key per logical operation. Replays return the original response with `Idempotent-Replayed: true`.
{
    "from_currency": "USD",
    "to_currency": "EUR",
    "amount": "100.00"
}

Responses: 201 · 409 · 422

Security

POST/api/v1/2fa/setupGenerate a TOTP secret🔒

Responses: 200 · 401 · 422

POST/api/v1/2fa/enableConfirm a code, enable 2FA and receive recovery codes🔒
{
    "code": "123456"
}

Responses: 200 · 401 · 422

POST/api/v1/2fa/disableDisable 2FA with a TOTP or recovery code🔒
{
    "code": "123456"
}

Responses: 200 · 401 · 422

GET/api/v1/tokensList personal API tokens🔒

Responses: 200 · 401 · 422

POST/api/v1/tokensCreate a personal API token🔒
{
    "name": "CI"
}

Responses: 200 · 401 · 422

DELETE/api/v1/tokens/{id}Revoke a token🔒
id (path, required)

Responses: 200 · 401 · 422

GET/api/v1/auditAudit trail (last 50 events)🔒

Responses: 200 · 401 · 422

Ledger

GET/api/v1/ledger/verifyProve every journal entry nets to zero

Responses: 200 · 401 · 422

Demo project · Portfolio