# List cash transactions

Returns every cash movement across all accounts belonging to the specified client_id. Each transaction includes its id, transactionType (e.g. deposit, withdrawal, or cash leg of a fund order), linked references (ref, refType, clientRef, executorRef), debit and credit accounts, monetary details (amount, currency), and full lifecycle timestamps (createdDate, modifiedDate, settlementDate). Use this endpoint to audit or reconcile every cash inflow and outflow associated with the client.

Endpoint: GET /v2/partner/client/{client_id}/transaction/cash
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"

  - `ref` (string)
    Match transactions to this ref
    Example: "de9b6d5e-bda0-44f6-9193-f241014f18d5"

  - `reftype` (string)
    Match transactions refType to this reftype
    Example: "subscription"

## 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"

  - `transactionType` (string, required)
    Account type

  - `aborted` (boolean)
    Transaction has been aborted.

  - `abortedReason` (string)
    Error code or freetext explaining abort
    Example: "referenced_order_canceled"

  - `ref` (string)
    Transaction reference. External id. 255 chars.

  - `refType` (any)
    The type of reference. Text or object Id

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

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

  - `amount` (number, required)
    Transaction amount as a number
    Example: 1.2

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

  - `executorRef` (string)
    Id or reference to the client placing the order, authorized by power of attorney.

Reference should be SSN of the individual client
    Example: "197001010003"

  - `clientRef` (string)
    Client applied ref
    Example: "my_order_123"

  - `freetext` (string)
    Free text of transaction
    Example: "Hello world"

  - `instrument` (string)
    Id of instrument if it is a transaction related to a specific instrument but not an order, ie retrocession
    Example: "SE0012193019SEK"

  - `startDate` (string)
    If a transaction is regarding a period of time

  - `endDate` (string)
    If a transaction is regarding a period of time

  - `createdDate` (string)
    Date when transaction was created
    Example: "2018-12-13t23:59:00.001z"

  - `modifiedDate` (string)
    Date when last modified
    Example: "2018-12-13t23:59:00.001z"

  - `settlementDate` (string)
    Date when transaction was settled, null if not settled
    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