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 centsAuth
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 | GBPcategory (query) groceries, dining, …q (query) Search descriptionpage (query) Page (1-based)limit (query) 1-100Responses: 200 · 401 · 422
GET/api/v1/insightsSpending by category and balance history🔒
days (query) 7 | 30 | 90Responses: 200 · 401 · 422
FX
GET/api/v1/ratesMid-market rates and fee
Responses: 200 · 401 · 422
GET/api/v1/quotesQuote an exchange
from (query) USDto (query) EURamount (query) 100.00Responses: 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