---
title: "Get all transactions across accounts"
method: GET
path: "/v1/transactions"
tags: ["Transactions"]
---

# Get all transactions across accounts

`GET /v1/transactions`

Get all transactions across accounts

## Query parameters

- `batch_id` string, uuid
- `transaction_state` 'Created' | 'Submitted' | 'Executed' | 'Failed' | 'Settled' — Transaction State.
- `payment_type` 'Local' | 'InternalTransfer' | 'FXTransfer' | 'LocalReturnPayment' | 'Fee'
- `customer_account_id` string, uuid
- `from` string, date-time
- `to` string, date-time
- `reference` string, string
- `external_id` string, string
- `account_name` string, string
- `cursor` string, string, nullable
- `page_size` integer

## Response `200`

Successfully retrieved transactions

- ListTransactionsPagedResponse
  - `pages` CursorString, required
    - `next` string, nullable
    - `size` integer, required
  - `results` Transaction[], required
    - union — Transaction Container.
      - object — Payment.
        - `account_id` string, uuid, required — The account that the transaction applies to.
        - `amount_with_fee` integer, required — The transaction amount including the fee char.
        - `authorised_at` string, date-time, nullable — When the transaction passed transaction monitoring checks.
        - `batch` TransactionBatch
          - `batch_id` string, uuid, required — Which batch the payment was created from.
          - `batch_sequence_no` integer, required — The sequence number of the payment within that batch.
        - `beneficiary` BeneficiaryDetails, required — Account details of the payment beneficiary.
          - `identifier` union, required
            - object
              - …
            - object
              - …
            - object
              - …
          - `name` string, string, required — Name of the beneficiary account.
        - `beneficiary_extra` BeneficiaryExtraDetails — Additional details of the beneficiary. It will be not set for inbound payments.
          - `address` Address
            - `country_code` string, string, required
            - `line_1` string, string, required
            - `line_2` string, string, nullable — ***optional*** for `AED` payments but ***mandatory*** for `USD` payments
            - `line_3` string, string, nullable
            - `line_4` string, string, nullable
          - `bic_code` string, string, nullable — Bank identifier code (BIC) of the beneficiary.
        - `created_at` string, date-time, required — When the transaction was created.
        - `currency` 'AED' | 'USD' | 'JOD' | 'EGP' | 'SAR' | 'GBP' | 'EUR' | 'HKD' | 'CNH' | 'SGD', required
        - `direction` 'Inbound' | 'Outbound', required — Transaction direction.
        - `executed_at` string, date-time, nullable — When the transaction was cleared by the bank.
        - `external_id` string, nullable — The external ID set when creating the transaction.
        - `external_reference` string, required — Transaction reference.
        - `failed_at` string, date-time, nullable — When the transaction was failed.
        - `failure_reason` union
          - object — Error returned by the bank.
            - `bank_error` string, required — Error returned by the bank.
          - 'insufficient_funds' — Account did not have sufficient funds.
          - 'internal_accounts_differ'
          - object
            - `system_error` string, required
          - object
            - `compliance_error` string, required
          - 'account_frozen'
        - `fee_amount` integer, required — The fee amount charged for the payment.
        - `fee_source` union
          - object
            - `type` 'included_in_payment', required
          - object
            - `type` 'primary_account', required
        - `id` string, uuid, required — Transaction id.
        - `instructed_amount` integer, required — The transaction amount.
        - `purpose` 'charity' | 'commercial_investment' | 'corporate_card' | 'credit_card' | 'dividend' | 'family' | 'financial_services' | 'goods_sold' | 'goods_bought' | 'government' | 'insurance' | 'intergroup_transfer' | 'intra_group_dividends' | 'information_technology' | 'leasing' | 'loan_charges' | 'merchant_settlement' | 'mobile_wallet' | 'non_resident_transfer_between_accounts' | 'none' | 'pension' | 'personal_expenses' | 'prepaid_cards' | 'professional' | 'rental' | 'resident_transfer_between_accounts' | 'salaries' | 'tax' | 'telecommunications' | 'travel' | 'utility_bill', required — Enum representing different payment purposes.
        - `remitter` RemitterDetails, required — Account details of the payment remitter.
          - `identifier` union, required
            - object
              - …
            - object
              - …
            - object
              - …
          - `name` string, string, required — Name of the remitter account.
        - `scheme` 'uae_fts' | 'uae_ipp' | 'swift' | 'fedwire' | 'ach' | 'sepa' | 'sepa_instant' | 'faster_payments'
        - `state` 'Created' | 'Submitted' | 'Executed' | 'Failed' | 'Settled', required — Transaction State.
        - `submitted_at` string, date-time, nullable — When the transaction was submitted to the bank.
        - `type` 'local_payment', required
      - object — Payment that has been returned.
        - `account_id` string, uuid, required — The account that the transaction applies to.
        - `beneficiary` BeneficiaryDetails, required — Account details of the payment beneficiary.
          - `identifier` union, required
            - object
              - …
            - object
              - …
            - object
              - …
          - `name` string, string, required — Name of the beneficiary account.
        - `created_at` string, date-time, required — When the transaction was created.
        - `currency` 'AED' | 'USD' | 'JOD' | 'EGP' | 'SAR' | 'GBP' | 'EUR' | 'HKD' | 'CNH' | 'SGD', required
        - `direction` 'Inbound' | 'Outbound', required — Transaction direction.
        - `external_reference` string, required — Transaction reference.
        - `id` string, uuid, required — Transaction id.
        - `instructed_amount` integer, required — The transaction amount.
        - `reason` string, string, required — The reason why the payment has been returned.
        - `remitter` RemitterDetails, required — Account details of the payment remitter.
          - `identifier` union, required
            - object
              - …
            - object
              - …
            - object
              - …
          - `name` string, string, required — Name of the remitter account.
        - `returned_id` string, uuid, required — The id of the outbound payment that has been returned.
        - `state` 'Created' | 'Submitted' | 'Executed' | 'Failed' | 'Settled', required — Transaction State.
        - `type` 'local_return_payment', required
      - object — Internal transfer - between two accounts.
        - `account_id` string, uuid, required — The account that the transfer applies to.
        - `counterpart_account_id` string, uuid, required — When `direction` is `Inbound` it contains the account id of the remitter. When `direction` is `Outbound` it contains the account id of the beneficiary.
        - `created_at` string, date-time, required — When the transaction was created.
        - `currency` 'AED' | 'USD' | 'JOD' | 'EGP' | 'SAR' | 'GBP' | 'EUR' | 'HKD' | 'CNH' | 'SGD', required
        - `direction` 'Inbound' | 'Outbound', required — Transaction direction.
        - `external_id` string, nullable — The external ID set when the internal transfer was created.
        - `external_reference` string, required — User-friendly transfer reference.
        - `failed_at` string, date-time, nullable — When the transaction failed.
        - `failure_reason` union
          - object — Error returned by the bank.
            - `bank_error` string, required — Error returned by the bank.
          - 'insufficient_funds' — Account did not have sufficient funds.
          - 'internal_accounts_differ'
          - object
            - `system_error` string, required
          - object
            - `compliance_error` string, required
          - 'account_frozen'
        - `id` string, uuid, required — Id of the transfer.
        - `instructed_amount` integer, required — The transfer amount.
        - `settled_at` string, date-time, nullable — When the transaction settled.
        - `state` 'Created' | 'Booked' | 'Failed' | 'Settled', required — Internal transfer state
        - `type` 'internal_transfer', required
      - object — Exchange transfer - between two accounts held in different currencies.
        - `account_id` string, uuid, required — The account that the transfer applies to.
        - `counterpart_account_id` string, uuid, required — When `direction` is `Inbound` it is the ID of the account that was debited When `direction` is 'Outbound' it is the ID of the account that was credited
        - `counterpart_amount` integer, required — When `direction` is `Inbound` it is the counterpart transaction amount that was debited from the counterpart account. When `direction` is `Outbound` it is the counterpart transaction amount that was credited from the counterpart account.
        - `counterpart_currency` 'AED' | 'USD' | 'JOD' | 'EGP' | 'SAR' | 'GBP' | 'EUR' | 'HKD' | 'CNH' | 'SGD', required
        - `created_at` string, date-time, required — When the transaction was created.
        - `currency` 'AED' | 'USD' | 'JOD' | 'EGP' | 'SAR' | 'GBP' | 'EUR' | 'HKD' | 'CNH' | 'SGD', required
        - `direction` 'Inbound' | 'Outbound', required — Transaction direction.
        - `executed_at` string, date-time, nullable — When the transaction was cleared by the bank.
        - `external_reference` string, required — User-friendly transaction reference.
        - `failed_at` string, date-time, nullable — When the transaction was failed.
        - `failure_reason` union
          - object — Error returned by the bank.
            - `bank_error` string, required — Error returned by the bank.
          - 'insufficient_funds' — Account did not have sufficient funds.
          - 'internal_accounts_differ'
          - object
            - `system_error` string, required
          - object
            - `compliance_error` string, required
          - 'account_frozen'
        - `id` string, uuid, required — Id of the transaction.
        - `instructed_amount` integer, required — When `direction` is `Inbound` it is the amount that was credited into the account. When `direction` is `Outbound` it is the amount that was debited from the account.
        - `rate` number, float, required — The exchange rate used for the transaction.
        - `state` 'Created' | 'Submitted' | 'Executed' | 'Failed' | 'Settled', required — Internal transfer state
        - `submitted_at` string, date-time, nullable — When the transaction was submitted to the bank.
        - `type` 'f_x_transfer', required
      - object — Fee debit
        - `account_id` string, uuid, required
        - `amount` integer, required
        - `currency` 'AED' | 'USD' | 'JOD' | 'EGP' | 'SAR' | 'GBP' | 'EUR' | 'HKD' | 'CNH' | 'SGD', required
        - `fee_target` FeeTargetRef, required
          - `reference` string, uuid, required
          - `type` 'Transaction', required
        - `id` string, uuid, required
        - `timestamp` string, date-time, required
        - `type` 'fee_debit', required

---

[API](https://skmtc.net/lorum/apis/auth-api.md) · [All operations](https://skmtc.net/lorum/apis/auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lorum/auth-api/revisions/f9b8935027e3/schema)