F
Finsam Tech·
API Reference

Your bank app's backend. No database to set up.

Finsam Tech is a plain REST API — call it with fetch or curl from any language or platform. You never touch a database directly; everything happens through these endpoints, and your accounts can transact with every other bank on the network.

Getting started

  1. Register once with a name, email, and password to get your API key — every request after this carries it in an Authorization header, nothing else to configure.
  2. Lost your key? Sign in with the same email + password to get a new one — no need to register again.
  3. Create your bank — one call, returns a bankId.
  4. Open accounts under your bank whenever your app needs one — each gets a routable account number.
  5. Call transfer to move money to any account number on the network — your bank's or anyone else's.

Endpoints

POST/v1/developersno auth

Register as a developer. Requires a password (min. 8 characters) — returns your API key, shown once, save it immediately.

POST/v1/developers/loginno auth

Sign in with email + password. Issues a new API key and retires the old one — this is also how you recover from a lost key.

POST/v1/banksBearer key

Create your bank. One developer, one bank.

POST/v1/accountsBearer key

Open an account under your bank.

GET/v1/accounts/:acctNumberBearer key

Look up any account on the network by number — name enquiry before a transfer. Balance is only included if you own the account.

POST/v1/transfersBearer key

Move money from an account you own to any account on the network. Atomic — either it fully completes or nothing changes.

GET/v1/accounts/:acctNumber/transfersBearer key

Transfer history for an account you own, most recent first.

GET/v1/transfers/:idBearer key

Look up a single transfer by its ID.

This page is documentation only — no calls happen from this file. Wherever you build your actual bank app (any stack, any language), copy the examples above with your real base URL and API key.