List all accounts

GET /v1/accounts

Query parameters

  • page integer(int32)

    Index of the requested page.

    Minimum value is 1. Default value is 1.

  • size integer(int32)

    Number of elements per page in response.

    Minimum value is 1, maximum value is 100. Default value is 10.

Responses

  • 200 application/json

    OK

    Hide response attributes Show response attributes AccountPage
    • results array[Account] Required

      Elements of the page.

      Hide results attributes Show results attributes Account
      • id string(uuid) Required

        ID of the account.

      • name string Required

        Name of the account, as seen in the Memo Bank interface.

      • status string Required

        Status of the account.

        Values are active or closed.

      • balance integer(int64) Required

        Balance of the account, in cents. It represents the available money on the account at the time of the request. Note that authorized overdrafts are not included in the balance.

      • currency string Required

        Currency of the account balance, in ISO 4217 format.

      • iban string Required

        Main IBAN of the account.

      • type string Required

        Type of the account.

        Values are current_account, ring_fenced_account, settlement_account, specially_dedicated_account, trust_account, meal_voucher_account, or booster_account.

      • is_main boolean Required

        Flag indicating if this account is the main account of your workspace.

    • has_prev boolean Required

      Flag indicating if there is a previous page.

    • has_next boolean Required

      Flag indicating if there is a next page.

GET /v1/accounts
curl \
 -X GET https://api.memo.bank/v1/accounts \
 -H "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
  "results": [
    {
      "id": "db2b50c0-a943-4eb1-a69f-fa37f112daa8",
      "name": "Main account",
      "status": "active",
      "balance": 42,
      "currency": "EUR",
      "iban": "FR7617338000017498690379033",
      "type": "current_account",
      "is_main": true
    }
  ],
  "has_prev": true,
  "has_next": true
}