Fake bank customers API

400 customers from the Bank API, a fake banking API. Account holders.

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

The first three customers

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

Sample records

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

[
  {
    "id": 1,
    "created_at": "2025-07-10T20:00:54Z",
    "updated_at": "2025-07-10T20:00:54Z",
    "name": "Omar Garcia",
    "email": "[email protected]",
    "phone": "+1-586-362-2216",
    "date_of_birth": "1995-07-11",
    "address": {
      "line1": "9602 Cedar Pl",
      "city": "Lisbon",
      "region": "Lisboa",
      "postal_code": "DG4EXF",
      "country": "PT"
    },
    "segment": "business",
    "kyc_status": "verified",
    "risk_score": 24
  },
  {
    "id": 2,
    "created_at": "2022-12-04T07:31:11Z",
    "updated_at": "2022-12-04T07:31:11Z",
    "name": "Max Jones",
    "email": "[email protected]",
    "phone": "+1-904-260-5006",
    "date_of_birth": "1979-05-25",
    "address": {
      "line1": "5123 Cypress St",
      "city": "Dubai",
      "region": "Dubai",
      "postal_code": "CP74SK",
      "country": "AE"
    },
    "segment": "retail",
    "kyc_status": "pending",
    "risk_score": 27
  },
  {
    "id": 3,
    "created_at": "2026-03-16T01:19:57Z",
    "updated_at": "2026-03-16T01:19:57Z",
    "name": "Clara Romero",
    "email": "[email protected]",
    "phone": "+1-423-694-3693",
    "date_of_birth": "2004-11-27",
    "address": {
      "line1": "9742 Main Way",
      "city": "Johannesburg",
      "region": "Gauteng",
      "postal_code": "MLGX59",
      "country": "ZA"
    },
    "segment": "student",
    "kyc_status": "verified",
    "risk_score": 31
  }
]

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.
`name`required	string
`email`required	string
`phone`	string
`date_of_birth`	date
`address`	json { line1, line2?, city, region, postal_code, country }
`segment`	enum	`retail` `premium` `business` `student`
`kyc_status`	enum	`pending` `verified` `rejected`
`risk_score`	int	min 0, max 100

Relations: accounts → the accounts whose customer_id is this customer; cards → the cards whose customer_id is this customer. Use ?expand=accounts,cards to embed them, or the nested routes.

Endpoints

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

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

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

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

DELETE/v1/bank/customers/{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/customers/{id}/accountsIts accounts, as a page with all the list options.

GET/v1/bank/customers/{id}/cardsIts cards, as a page with all the list options.

Try it

List with a filter

curl "https://api.sondahub.com/v1/bank/customers?segment=premium&risk_score_gte=1&limit=3"

One record

curl https://api.sondahub.com/v1/bank/customers/1

Its accounts

curl "https://api.sondahub.com/v1/bank/customers/1/accounts?limit=5"

Create

curl -i -X POST https://api.sondahub.com/v1/bank/customers \
  -H "Content-Type: application/json" \
  -d '{"name":"A name","email":"A email","segment":"retail","kyc_status":"pending"}'

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

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

Delete the one you created

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

Query recipes

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

What	Request
Page 2, 50 at a time (of 400)	/v1/bank/customers?page=2&limit=50
Only segment = retail	/v1/bank/customers?segment=retail
Risk score between two values, largest first	/v1/bank/customers?risk_score_gte=1&risk_score_lte=500&sort=-risk_score
Newest first by created at	/v1/bank/customers?sort=-created_at&limit=5
Name contains “omar”	/v1/bank/customers?name_like=omar
Full-text search	/v1/bank/customers?q=omar
Only some fields	/v1/bank/customers?fields=id,name&limit=5
Its accounts (nested route)	/v1/bank/customers/1/accounts?limit=5
Just the count	/v1/bank/customers?limit=1&fields=id

GraphQL

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

{
  customers(limit: 3, sort: "-id", filter: { segment: retail }) {
    total
    data {
      id name email phone
      accounts(limit: 2) { id }
    }
  }
}

Run it

curl https://api.sondahub.com/v1/bank/graphql -H "Content-Type: application/json" -d '{"query": "{ customers(limit: 3, sort: \"-id\", filter: { segment: retail }) { total data { id name email phone accounts(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/customers.

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":"customers","filters":{"segment":"retail"},"limit":3}}}'

More in the Bank API

accounts (640) · 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.