GET
/
accounts
cURL
curl --request GET \
  --url http://localhost:8080/accounts
{
  "data": [
    {
      "account_details": {
        "ifsc_code": "<string>"
      },
      "created_at": "<string>",
      "external_account_id": "<string>",
      "holder": "user:012345678901",
      "id": "<string>",
      "last_modified_at": "<string>"
    }
  ],
  "limit": 123,
  "offset": 123,
  "total": 123
}

Query Parameters

​
holder
string
required
​
holder_kind
null | enum<string>

Discriminator for [Holder] variants. Used at the wire boundary for split-field admin query params (?holder_kind=user&holder_id=...). Not stored as a DB column — the DB has only the URN-encoded holder column.

Available options:
user,
sponsor
​
status
null | enum<string>

Account lifecycle status.

Available options:
ACTIVE,
INACTIVE,
PENDING
​
account_type
null | enum<string>

Type of financial or health account.

Available options:
SAVINGS,
HSA,
EDUCATION,
SPONSOR
​
limit
integer<int32> | null
​
offset
integer<int32> | null

Response

List of accounts

​
data
object[]
required
​
limit
integer<int32>
required
​
offset
integer<int32>
required
​
total
integer<int64>
required