🚀 VaultsPay API v1 is live. See what's new →
AccountsGet Accounts

Get Accounts

GET{baseUrl}/be/api/v1/accounts

Query Parameters

ParameterTypeRequiredDescription
accountTypeStringNoReturn accounts matching this account type.
userIdIntegerNoReturn accounts belonging to this user ID.
shownMyAccountsBooleanNoIf true, only return accounts of the logged-in SaaS user.
thirdPartyConfigSlugStringNoFilter by third-party configuration slug.
currencyCodeStringNoFilter by currency code (e.g., AED).
transactionTypeStringNoFilter by transaction type.

Response

FieldTypeDescription
dataArrayList of account objects (same shape as Create Account response).
paginationObject{ currentPage, perPage, totalPages, totalCount, sort }.
200 — SUCCESS
{
  "data": [
    {
      "id": 12,
      "userId": 3,
      "accountType": "DIGITAL",
      "currencyCode": "AED",
      "currency": {
        "createdAt": "2024-10-07T04:56:49.699+00:00",
        "createdBy": null,
        "updatedAt": null,
        "updatedBy": null,
        "id": 2,
        "name": "United ARAB EMIRATE",
        "code": "AED",
        "isoCode": 784,
        "decimalPoint": 2,
        "type": "FIAT",
        "symbol": null,
        "icon": null,
        "status": true
      },
      "accountTitle": "VAULTSPAY CUSTOMER",
      "accountNumber": "30132278593204",
      "balance": 0,
      "balanceOnHold": 0,
      "totalTransactions": null,
      "status": "ACTIVE",
      "references": [],
      "iban": null,
      "isPrimary": true,
      "creditLimit": 1000
    }
  ],
  "pagination": {
    "currentPage": 1,
    "perPage": 20,
    "totalPages": 1,
    "totalCount": 1,
    "sort": "id: DESC"
  }
}