Get Accounts for an Individual End User

GET /v1/end-users/individuals//accounts — Returns all virtual accounts for an individual end user. Requires end-users:read scope.

Returns a paginated list of virtual accounts belonging to a specific individual end user. Accounts are only present once the end user has been successfully onboarded with at least one bank partner. Use the optional query parameters to search by account name, account number, or a general free-text term. The returned accounts can be used as the source or destination in payment operations.

​

Endpoint

GET /v1/end-users/individuals/{id}/accounts

Required scope: com.diameterpay.api/end-users.read

​

Request Headers

Authorization · string · required

Bearer token obtained from your OAuth 2.0 token endpoint. Format: Bearer {access_token}

​

Path Parameters

id · string · required

UUID v4 of the individual end user whose accounts you want to list.

​

Query Parameters

page · integer

Page number to return. Defaults to 1.

limit · integer

Number of records per page. Defaults to 10. Maximum is 100.

accountName · string

Exact-match filter on the account’s display name.

accountNumber · string

Exact-match filter on the account number.

freeSearch · string

General free-text search across multiple account fields such as account name, account number, and currency.

​

Response

Returns 200 OK with a paginated response envelope containing an array of virtual account objects.

data · array

Array of virtual account objects belonging to this end user.

Show account object fields

id · string

UUID v4 of the virtual account.

accountName · string

Display name of the account.

accountNumber · string

Account number assigned by the bank partner.

currency · string

ISO 4217 currency code (e.g. USD, EUR).

balance · string

Current available balance as a decimal string (e.g. "1500.00").

bankPartner · string

The bank partner that issued this account (e.g. PORTAGE, SLOVAK_SAVINGS_BANK).

status · string

Current account status (e.g. ACTIVE, INACTIVE, SUSPENDED).

endUserId · string

UUID v4 of the individual end user this account belongs to.

productId · string

UUID of the product associated with this account.

createdAt · string

ISO 8601 timestamp of when the account was created.

updatedAt · string

ISO 8601 timestamp of the most recent update.

pagination · object

Pagination metadata.

Show pagination fields

page · integer

The current page number.

limit · integer

Number of records returned per page.

totalItems · integer

Total number of accounts matching the filter criteria.

totalPages · integer

Total number of pages available given the current limit.

hasNextPage · boolean

true if there is at least one more page of results.

hasPreviousPage · boolean

true if this is not the first page.

​

Example Request

curl --request GET \
  --url 'https://api.sandbox.diameterpay.com/v1/end-users/individuals/f47ac10b-58cc-4372-a567-0e02b2c3d479/accounts?page=1&limit=10' \
  --header 'Authorization: Bearer {access_token}'

​

Filtering by Account Name

curl --request GET \
  --url 'https://api.sandbox.diameterpay.com/v1/end-users/individuals/f47ac10b-58cc-4372-a567-0e02b2c3d479/accounts?accountName=savings' \
  --header 'Authorization: Bearer {access_token}'

​

Example Response

{
  "data": [
    {
      "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
      "accountName": "Jane's Primary Account",
      "accountNumber": "1234567890",
      "currency": "USD",
      "balance": "1500.00",
      "bankPartner": "PORTAGE",
      "status": "ACTIVE",
      "endUserId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "productId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "createdAt": "2024-06-01T12:10:00.000Z",
      "updatedAt": "2024-06-01T12:10:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "totalItems": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  }
}