sondahub

sondahub / Bank API / Accounts

Fake accounts API

640 accounts from the Bank API, a fake banking API. Checking, savings, credit and loan accounts. balance is the current balance after every transaction.

Reads with filters, sorting, search and relations; writes that answer like a real server and stay in your session token. Same ids on every build. Free, no key, CORS open.

Connect

List
https://api.sondahub.com/v1/bank/accounts
One record
https://api.sondahub.com/v1/bank/accounts/{id}
OpenAPI 3
https://api.sondahub.com/v1/bank/openapi.json
GraphQL
https://api.sondahub.com/v1/bank/graphql
JSON file
https://api.sondahub.com/data/bank/accounts.json
MCP
https://api.sondahub.com/mcp · list_records
The first three accounts
curl "https://api.sondahub.com/v1/bank/accounts?limit=3"

Sample records

Records 1 to 3 of 640, exactly as GET /v1/bank/accounts/{id} answers them. The data file holds all of them.

[
  {
    "id": 1,
    "created_at": "2026-02-17T07:42:02Z",
    "updated_at": "2026-02-17T07:42:02Z",
    "number": "SH-1219-6590-2880",
    "iban": "SH83SOND74090620530218",
    "customer_id": 1,
    "type": "checking",
    "nickname": "Salary",
    "currency": "USD",
    "balance": 4143.74,
    "available": 4143.74,
    "credit_limit": null,
    "interest_rate": 0,
    "status": "active",
    "opened_at": "2026-02-17"
  },
  {
    "id": 2,
    "created_at": "2022-11-07T05:47:25Z",
    "updated_at": "2022-11-07T05:47:25Z",
    "number": "SH-5239-6931-3680",
    "iban": "SH28SOND69994077269746",
    "customer_id": 2,
    "type": "checking",
    "nickname": "Everyday",
    "currency": "GBP",
    "balance": 3411.94,
    "available": 3265.93,
    "credit_limit": null,
    "interest_rate": 0,
    "status": "active",
    "opened_at": "2022-11-07"
  },
  {
    "id": 3,
    "created_at": "2025-08-15T13:01:12Z",
    "updated_at": "2025-08-15T13:01:12Z",
    "number": "SH-1344-5898-3848",
    "iban": "SH26SOND95504623387177",
    "customer_id": 3,
    "type": "checking",
    "nickname": "Household",
    "currency": "USD",
    "balance": 5998.22,
    "available": 5998.22,
    "credit_limit": null,
    "interest_rate": 0,
    "status": "active",
    "opened_at": "2025-08-15"
  }
]

Fields

FieldTypeNotes
idread-onlyintAssigned by the server. Seed records keep their ids across restarts; records you create continue after the seed.
created_atread-onlydatetimeWhen the record was created (ISO 8601, UTC).
updated_atread-onlydatetimeWhen the record last changed.
numberread-onlystringUnique account number.
ibanread-onlystring
customer_idrequiredint → customers
typerequiredenumchecking savings credit loan
nicknamestring
currencystring
balancefloatCurrent balance. Negative on credit and loan accounts means money owed.
availablefloatBalance minus holds, or credit left.
credit_limitfloatCredit accounts only.
interest_ratefloatAnnual, percent.
statusenumactive frozen closed
opened_atdate

Relations: customer → one customer through customer_id; transactions → the transactions whose account_id is this account; cards → the cards whose account_id is this account. Use ?expand=customer,transactions,cards to embed them, or the nested routes.

Endpoints

GET/v1/bank/accountsA page, with every filter, sort, search, field and expand option.
POST/v1/bank/accountsCreate one: 201 with the record, its id, a Location header and the session token that keeps it; 422 names each field that is wrong.
GET/v1/bank/accounts/{id}One record, with an ETag; If-None-Match earns a 304.
PATCH/v1/bank/accounts/{id}Change the fields you send.
PUT/v1/bank/accounts/{id}Replace the record; required fields must all be there.
DELETE/v1/bank/accounts/{id}Answers 200 with what was removed (a real server’s 204 lives at /v1/utils/status/204); gone for the session.
GET/v1/bank/accounts/{id}/customerThe customer this record points at.
GET/v1/bank/accounts/{id}/transactionsIts transactions, as a page with all the list options.
GET/v1/bank/accounts/{id}/cardsIts cards, as a page with all the list options.

Try it

List with a filter
curl "https://api.sondahub.com/v1/bank/accounts?type=savings&balance_gte=10&expand=customer&limit=3"
One record
curl https://api.sondahub.com/v1/bank/accounts/1?expand=customer
Its transactions
curl "https://api.sondahub.com/v1/bank/accounts/1/transactions?limit=5"
Create
curl -i -X POST https://api.sondahub.com/v1/bank/accounts \
  -H "Content-Type: application/json" \
  -d '{"customer_id":1,"type":"checking","nickname":"Everyday","currency":"USD","status":"active"}'
Read it back: newest first (send the session token)
curl "https://api.sondahub.com/v1/bank/accounts?sort=-id&limit=3" \
  -H "X-Sondahub-Session: THE_TOKEN_FROM_THE_CREATE"
Change one field
curl -X PATCH https://api.sondahub.com/v1/bank/accounts/1 \
  -H "Content-Type: application/json" \
  -d '{"type":"savings"}'
Delete the one you created
curl -X DELETE https://api.sondahub.com/v1/bank/accounts/641 \
  -H "X-Sondahub-Session: THE_TOKEN_FROM_THE_CREATE"

Query recipes

Every list option works on accounts; these are ready to paste. All the options.

WhatRequest
Page 2, 50 at a time (of 640)/v1/bank/accounts?page=2&limit=50
Only type = checking/v1/bank/accounts?type=checking
Balance between two values, largest first/v1/bank/accounts?balance_gte=1&balance_lte=500&sort=-balance
Newest first by created at/v1/bank/accounts?sort=-created_at&limit=5
Nickname contains “salary”/v1/bank/accounts?nickname_like=salary
Full-text search/v1/bank/accounts?q=salary
Only some fields/v1/bank/accounts?fields=id,nickname&limit=5
Embed the customer/v1/bank/accounts/1?expand=customer
Its transactions (nested route)/v1/bank/accounts/1/transactions?limit=5
Just the count/v1/bank/accounts?limit=1&fields=id

GraphQL

The same accounts as the accounts query on https://api.sondahub.com/v1/bank/graphql, and one account as account(id: 1). Introspection is on. More on the GraphQL API.

{
  accounts(limit: 3, sort: "-id", filter: { type: checking }) {
    total
    data {
      id number iban customer_id
      customer { name }
      transactions(limit: 2) { id }
    }
  }
}
Run it
curl https://api.sondahub.com/v1/bank/graphql -H "Content-Type: application/json" -d '{"query": "{ accounts(limit: 3, sort: \"-id\", filter: { type: checking }) { total data { id number iban customer_id customer { name } transactions(limit: 2) { id } } } }"}'

From an AI agent (MCP)

The MCP server reaches the same rows with list_records, get_record, create_record, update_record and delete_record, and as the resource sondahub://bank/accounts.

tools/call
curl https://api.sondahub.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_records","arguments":{"api":"bank","collection":"accounts","filters":{"type":"checking"},"limit":3}}}'

More in the Bank API

customers (400) · cards (505) · transactions (7,674) · transfers (800) · fx rates (28)

The live streams, and the whole API on one page: Bank API. Other worlds: fake e-commerce API, fake IoT API, fake social media API, fake helpdesk API, fake flight booking API, fake user directory API.