Fake transactions API

7,674 transactions from the Bank API, a fake banking API. Every movement on an account. amount is signed: negative leaves the account. balance_after is the running balance.

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/transactions
One record: https://api.sondahub.com/v1/bank/transactions/{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/transactions.json
MCP: https://api.sondahub.com/mcp · list_records

The first three transactions

curl "https://api.sondahub.com/v1/bank/transactions?limit=3"

Sample records

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

[
  {
    "id": 1,
    "created_at": "2026-08-09T12:00:00Z",
    "updated_at": "2026-08-09T12:00:00Z",
    "account_id": 1,
    "reference": "TXN-U5Q4CVNY",
    "type": "transfer",
    "amount": -791.91,
    "currency": "USD",
    "balance_after": -2455.96,
    "description": "Transfer out",
    "merchant": null,
    "category": "transfer",
    "status": "posted",
    "card_id": null,
    "counterparty": {
      "name": "Savings",
      "account_number": "SH-5131-5344-2158"
    },
    "booked_at": "2026-08-09T12:00:00Z",
    "value_date": "2026-08-09"
  },
  {
    "id": 2,
    "created_at": "2026-08-11T23:00:00Z",
    "updated_at": "2026-08-11T23:00:00Z",
    "account_id": 1,
    "reference": "TXN-FWJJFJ2R",
    "type": "card",
    "amount": -143.52,
    "currency": "USD",
    "balance_after": -2599.48,
    "description": "City Power & Light",
    "merchant": "City Power & Light",
    "category": "utilities",
    "status": "posted",
    "card_id": 1,
    "counterparty": null,
    "booked_at": "2026-08-11T23:00:00Z",
    "value_date": "2026-08-11"
  },
  {
    "id": 3,
    "created_at": "2026-08-15T05:00:00Z",
    "updated_at": "2026-08-15T05:00:00Z",
    "account_id": 1,
    "reference": "TXN-8W3WUN34",
    "type": "fee",
    "amount": -12,
    "currency": "USD",
    "balance_after": -2611.48,
    "description": "ATM fee",
    "merchant": null,
    "category": "fees",
    "status": "posted",
    "card_id": null,
    "counterparty": null,
    "booked_at": "2026-08-15T05:00:00Z",
    "value_date": "2026-08-15"
  }
]

Fields

Field	Type	Notes
`id`read-only	int	Assigned by the server. Seed records keep their ids across restarts; records you create continue after the seed.
`created_at`read-only	datetime	When the record was created (ISO 8601, UTC).
`updated_at`read-only	datetime	When the record last changed.
`account_id`required	int → accounts
`reference`read-only	string	Unique.
`type`	enum	`card` `transfer` `deposit` `withdrawal` `fee` `interest` `payment` `refund`
`amount`required	float
`currency`	string
`balance_after`read-only	float
`description`	string
`merchant`	string
`category`	enum	`groceries` `dining` `transport` `fuel` `shopping` `utilities` `entertainment` `health` `travel` `subscriptions` `transfer` `income` `fees` `other`
`status`	enum	`pending` `posted` `reversed`
`card_id`	int → cards
`counterparty`	json { name, account_number? }
`booked_at`required	datetime
`value_date`	date

Relations: account → one account through account_id; card → one card through card_id. Use ?expand=account,card to embed them, or the nested routes.

Endpoints

GET/v1/bank/transactionsA page, with every filter, sort, search, field and expand option.

POST/v1/bank/transactionsCreate 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/transactions/{id}One record, with an ETag; If-None-Match earns a 304.

PATCH/v1/bank/transactions/{id}Change the fields you send.

PUT/v1/bank/transactions/{id}Replace the record; required fields must all be there.

DELETE/v1/bank/transactions/{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/transactions/{id}/accountThe account this record points at.

GET/v1/bank/transactions/{id}/cardThe card this record points at.

Try it

List with a filter

curl "https://api.sondahub.com/v1/bank/transactions?type=transfer&amount_gte=10&expand=account&limit=3"

One record

curl https://api.sondahub.com/v1/bank/transactions/1?expand=account

Create

curl -i -X POST https://api.sondahub.com/v1/bank/transactions \
  -H "Content-Type: application/json" \
  -d '{"account_id":1,"type":"card","amount":9.99,"category":"groceries","status":"pending","booked_at":"2026-09-30T12:00:00Z"}'

Read it back: newest first (send the session token)

curl "https://api.sondahub.com/v1/bank/transactions?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/transactions/1 \
  -H "Content-Type: application/json" \
  -d '{"type":"transfer"}'

Delete the one you created

curl -X DELETE https://api.sondahub.com/v1/bank/transactions/7675 \
  -H "X-Sondahub-Session: THE_TOKEN_FROM_THE_CREATE"

Query recipes

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

What	Request
Page 2, 50 at a time (of 7,674)	/v1/bank/transactions?page=2&limit=50
Only type = card	/v1/bank/transactions?type=card
Amount between two values, largest first	/v1/bank/transactions?amount_gte=1&amount_lte=500&sort=-amount
Newest first by created at	/v1/bank/transactions?sort=-created_at&limit=5
Currency contains “usd”	/v1/bank/transactions?currency_like=usd
Full-text search	/v1/bank/transactions?q=usd
Only some fields	/v1/bank/transactions?fields=id,currency&limit=5
Embed the account	/v1/bank/transactions/1?expand=account
Just the count	/v1/bank/transactions?limit=1&fields=id

GraphQL

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

{
  transactions(limit: 3, sort: "-id", filter: { type: card }) {
    total
    data {
      id account_id reference type
      account { number }
    }
  }
}

Run it

curl https://api.sondahub.com/v1/bank/graphql -H "Content-Type: application/json" -d '{"query": "{ transactions(limit: 3, sort: \"-id\", filter: { type: card }) { total data { id account_id reference type account { number } } } }"}'

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/transactions.

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":"transactions","filters":{"type":"card"},"limit":3}}}'

More in the Bank API

customers (400) · accounts (640) · cards (505) · 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.