# List client's accounts

Returns every investment account linked to client_id, including identifiers, type, status, balances, positions, linked bank accounts, currency, and timestamps. Use this to display or manage the client's full account set.

Endpoint: GET /v2/partner/client/{client_id}/account
Version: 2.0.0
Security: oAuth

## Query parameters:

  - `start` (string)
    The sortedId to start from. Use for pagination.
    Example: "20240101abcdef"

  - `limit` (number)
    Limit results. Default is none
    Example: 100

  - `modifiedFrom` (string)
    The modifiedDate to start from. Use for reconciliation.
    Example: "2024-01-01T00:00:01.000Z"

  - `ssn` (string)
    The social security number of account owner

## Path parameters:

  - `client_id` (string, required)
    The ID of requested client.
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

## Response 200 fields (application/json):

  - `id` (string)
    UUID (Universally Unique Identifier)
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

  - `sortedId` (string)
    ULID (Universally Unique Lexicographically Sortable Identifier)
    Example: "01ARZ3NDEKTSV4RRFFQ69G5FAV"

  - `ref` (string)
    ref is a unique account number, based on
epoch, length and Luhn. OCR /w length digit compliant.
    Example: "160367146695159"

  - `name` (string, required)
    Name of account
    Example: "Spar"

  - `status` (string)
    Status of account
    Enum: "pending", "active", "rejected", "confirm"

  - `accountType` (any, required)
    Account type

  - `serviceType` (any, required)
    Account service type

  - `owner` (object)

  - `owner.firstName` (string)
    First name of account holder
    Example: "Ben"

  - `owner.lastName` (string)
    Last name of account holder
    Example: "Rangel"

  - `owner.fullName` (string)
    Full name of account holder
    Example: "Ben Rangel"

  - `owner.ssn` (string)
    Social security number of account holder
    Example: "197001010003"

  - `balance` (number)
    Snapshot of cash amount on account
    Example: 100

  - `amounts` (object)
    Amounts on account

  - `amounts.deposited` (number)
    Amount deposited to account
    Example: 123.45

  - `amounts.withdrawn` (number)
    Amount withdrawn from account
    Example: 123.45

  - `positions` (array)
    List of positions held

  - `positions.instrument` (string)
    Instrument identifier

  - `positions.units` (number)
    Number of units

  - `positions.unitsSettled` (number)
    Number of units settled

  - `positions.value` (number,null)
    The total value of the position

  - `positions.closePrice` (number,null)
    Last closing price

  - `positions.gav` (number)
    Average aquisition value (Genomsnittligt Anskaffningsvärde)

  - `deleted` (boolean, required)
    Is account deleted?

  - `clientId` (string, required)
    UUID (Universally Unique Identifier)
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

  - `bankAccounts` (array)

  - `bankAccounts.iban` (string, required)
    IBAN (ISO 13616, International Bank Account Number)
    Example: "SE7280000810340009783242"

  - `bankAccounts.bban` (string)
    Local bank account number
    Example: "666 666 666"

  - `bankAccounts.bank` (string, required)
    Bank name
    Example: "Buy n' Large"

  - `bankAccounts.createdDate` (string)
    Date when acocunt was created
    Example: "2018-12-13T23:59:00.001Z"

  - `bankAccounts.modifiedDate` (string)
    Date when last modified
    Example: "2018-12-13T23:59:00.001Z"

  - `bankAccounts.deletedDate` (string)
    Date when and if deleted
    Example: "2018-12-13T23:59:00.001Z"

  - `bankAccounts.validated` (boolean)
    Whether the bank account is validated by account check service.
Required for withdrawals
    Example: true

  - `currency` (string, required)
    Three letter ISO currency code
    Example: "SEK"

  - `deletedDate` (string)
    Date when flagged as deleted
    Example: "2018-12-13T23:59:00.001Z"

## Response 400 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "invalid_request"

  - `error_description` (string)
    Description of error

## Response 401 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "unauthorized"

  - `error_description` (string)
    Description of error

## Response 403 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "forbidden"

  - `error_description` (string)
    Description of error

## Response 500 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "server_error"

  - `error_description` (string)
    Description of error

## Response 503 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "service_unavailable"

  - `error_description` (string)
    Description of error