---
title: "List transactions"
method: GET
path: "/v2/transactions"
tags: ["Transactions"]
---

# List transactions

`GET /v2/transactions`

## Request

- Base URL: `https://sandbox.pismolabs.io/transactions-core`
- URL: `https://sandbox.pismolabs.io/transactions-core/v2/transactions`
- Auth: HTTP bearer

List transactions without their metadata. If you provide at least one of the following parameters, the `eventDateStart` parameter is optional.
- `id`
- `authorizationId`
- `authorizationIds`
- `statementId`
- `authorizationTrackingId`
- `numberOfLatestTransactions`

If you don't provide any of the above parameters, you must include the `eventDateStart` parameter, and the maximum allowed query range is 90 days.

## Query parameters

- `statementId` integer
- `customerId` integer
- `transactionTypeId` integer
- `processingCode` string
- `credit` boolean
- `statementPost` boolean
- `authorizationId` integer
- `authorizationType` 'NETWORK' | 'PLATFORM'
- `eventDateStart` string
- `order` 'asc' | 'desc'
- `eventDateEnd` string
- `numberOfLatestTransactions` integer
- `authorizationTrackingId` string
- `pageSize` integer
- `pageOffset` integer
- `ids` integer[]
- `userCategory` string
- `paymentMethodId` string

## Response `200`

OK

- object
  - `has_next` boolean: Indicates whether there are more pages after the current page.
  - `items` object[]: Items returned by the request
    - `id` integer: Transaction ID
    - `program_id` integer: Program ID
    - `account_id` integer: Account ID
    - `statement_id` integer: Statement ID
    - `installment` integer: Transaction installment number
    - `number_of_installments` integer: Total number of installments
    - `soft_descriptor` string: Soft descriptor of transaction. This is the description that shows on the customer's statement after it is authorized, but before it is settled.
    - `processing_code` string: Processing code used to create the transaction.
    - `processing_description` string: Processing code description
    - `customer_id` integer: Customer ID
    - `user_category` string: User category
    - `transaction_group` string: Transaction group
    - `entry_mode` string: Transaction Entry Mode
    - `amount` Amount[]
      - `type` 'PRINCIPAL' | 'LOCAL' | 'SETTLEMENT': Amount type - `PRINCIPAL`: Transaction amount in the customer’s account currency (already converted). - `LOCAL`: Transaction amount in the merchant’s local currency, where the purchase was made. - `SETTLEMENT`: Settlement amount that is typically defined by the issuer and usually matches the `PRINCIPAL` currency.
      - `currency` string: ISO-4217 alphabetic code (3 characters) for transaction currency.
      - `value` number: Amount value
    - `tax` Tax[]: Transaction taxes
      - `currency` string: ISO-4217 alphabetic code (3 characters) for transaction currency.
      - `type` 'IOF' | 'IOF_DAILY' | 'INTEREST': Tax type
      - `value` number: Tax value
    - `event_date` string, date-time: Event timestamp in the UTC (zero-hour offset) ISO 8601 format (yyyy-MM-ddThh:mm:ssZ).
    - `event_datetime` string, date-time: Event timestamp in the UTC (zero-hour offset) RFC 3339 format, which includes milliseconds (yyyy-MM-ddThh:mm:ss.SSSZ).
    - `payment_date` string, date-time: Payment timestamp provided by the user in the ISO 8601 format (yyyy-MM-ddThh:mm:ssZ).
    - `payment_datetime` string, date-time: Payment timestamp provided by the user in the RFC 3339 format, which includes milliseconds (yyyy-MM-ddThh:mm:ss.SSSZ).
    - `created_at` string, date-time: Transaction creation date (ISO 8601)
    - `transaction_type` TransactionType
      - `id` integer: Transaction type ID
      - `description` string: Transaction type description
      - `credit` boolean: Indicates if the transaction type is a credit or debit operation.
      - `posted_transaction` boolean: Indicates whether transactions are posted on statements (`true`) or not (`false`).
      - `balance_impact_id` integer: Balance impact ID
      - `category` string: Transaction type category
    - `card` Card: Contains details about the card used in a transaction. * For transactions from card network operations, this object includes card information. * For platform operations, this object is empty. Whether card information appears depends on what was provided during authorization, not on the transaction type.
      - `id` integer: Card ID
      - `name` string: Card name
    - `authorization` Authorization
      - `id` integer: Authorization ID
      - `type` 'PLATFORM' | 'NETWORK': Authorization's type
      - `code` string: Authorization code or Network Approval Code
      - `payment_method_id` string: Payment method
      - `network` 'VISA' | 'MASTERCARD': Visa or Mastercard network
      - `tracking_id` string: Idempotency tracking ID
      - `correlated_authorization_id` integer: Authorization ID generated by force or installment operations when the `original_authorization` field is provided. See the [Force operation](doc:force-operation) and [Installments payment](doc:installments-payment) guides for more information.
      - `original_account_id` integer: Original account ID. This field is used when the transaction is linked to a authorizaiton that was made on a different account than the one being queried.
    - `merchant` Merchant
      - `id` string: Merchant ID
      - `type` string: Merchant type
      - `name` string: Merchant name
      - `city` string: Merchant city
      - `state` string: Merchant's state. In some cases, for countries other than the U.S., it can indicate the country code of the merchant instead.
      - `category` MerchantCategory
        - `code` string: Merchant category code (MCC). Provided by the network (Visa or Mastercard).
        - `description` string: Merchant category description
        - `group_name` string: Merchant category group name
        - `network_group` string: Merchant category group name sent by network

## Other responses

- `400`: Bad request
- `500`: Internal error

---

[API](https://skmtc.dev/pismo/apis/core-platform-transactions.md) - [All operations](https://skmtc.dev/pismo/apis/core-platform-transactions/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/core-platform-transactions/revisions/0446e20d4547?raw)