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

# List of Transactions

`GET /transactions`

Returns a list of transactions. You can use the `limit`, `page`, `sortBy`, `sortDirection` parameters to filter and sort the results. You can also use filters like the `partnerSubmissionStatus` to e.g. only get transactions that you as a partner have not synced yet.

## Query parameters

- `organizationId` string, uuid, required
- `status` 'DECLINED' | 'PENDING' | 'REVERSED' | 'CONFIRMED' | 'BOOKED'
- `type` 'PURCHASE' | 'CASH_WITHDRAWAL' | 'REFUND' | 'CHARGEBACK' | 'RECHARGE' | 'STATUS_INQUIRY'
- `partnerSubmissionStatus` 'NOT_SYNCED' | 'SYNCED' | 'TEMP_LOCKED' | 'LOCKED'
- `cardAccountId` string, uuid
- `cardholderId` string, uuid
- `cardId` string, uuid
- `fromDate` string, date-time
- `toDate` string, date-time
- `byDateField` 'confirmedAt' | 'createdAt' | 'bookedAt' | 'updatedAt', nullable
- `limit` integer
- `page` integer
- `sortBy` 'organizationId' | 'status' | 'type' | 'cardholderId' | 'cardId' | 'merchantId' | 'confirmedAt' | 'createdAt'
- `sortDirection` 'ASC' | 'DESC'

## Response `200`

Ok

- object
  - `data` object[]
    - `transactionId` string, uuid — The ID of the transaction.
    - `organizationId` string, uuid — The ID of the organization this transaction belongs to.
    - `cardAccountId` string, uuid — The ID of the [card account](/docs/card-account) this transaction belongs to.
    - `cardholderId` string, uuid — The ID of the [cardholder](/docs/cardholder-entity) this transaction belongs to.
    - `cardId` string, uuid — The ID of the card this transaction belongs to.
    - `status` 'DECLINED' | 'PENDING' | 'REVERSED' | 'CONFIRMED' | 'BOOKED' — The status of the transaction.
    - `type` 'PURCHASE' | 'CASH_WITHDRAWAL' | 'REFUND' | 'CHARGEBACK' | 'RECHARGE' | 'STATUS_INQUIRY' — The type of the transaction.
    - `partnerSubmissionStatus` 'NOT_SYNCED' | 'SYNCED' | 'TEMP_LOCKED' | 'LOCKED' — The partner submission status of the transaction. `TEMP_LOCKED` makes the transaction immutable for cardholders within Pliant apps. `TEMP_LOCKED` can be changed to `SYNCED`. `LOCKED` makes them immutable for all users and is the final state that cannot be modified anymore.
    - `billingAmount` object — The amount that was billed to the cardholder, in the currency of the card account.
      - `value` number — The value of the monetary amount, converted to minor units of the currency. For instance 1.00 EUR is 100 cents, thus the value here is `100`. See our [guides](/docs/monetary-values) for more details about how to handle monetary amounts.
      - `currency` string — The currency of the monetary amount in ISO 4217 format, for example `EUR` for Euro or `USD` for US Dollar.
    - `transactionAmount` object — The amount that was transacted.
      - `value` number — The value of the monetary amount, converted to minor units of the currency. For instance 1.00 EUR is 100 cents, thus the value here is `100`. See our [guides](/docs/monetary-values) for more details about how to handle monetary amounts.
      - `currency` string — The currency of the monetary amount in ISO 4217 format, for example `EUR` for Euro or `USD` for US Dollar.
    - `confirmedAt` string, date-time, nullable — The date-time when the transaction was confirmed.
    - `createdAt` string, date-time, nullable — The date-time when the transaction was created.
    - `updatedAt` string, date-time, nullable — The date-time when the transaction was updated.
  - `hasNextPage` boolean — Indicates whether there is a next page available.

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `429` — unresolved $ref
- `500` — unresolved $ref

---

[API](https://skmtc.dev/getpliant/apis/pliant-customer-api.md) · [All operations](https://skmtc.dev/getpliant/apis/pliant-customer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getpliant/pliant-customer-api/revisions/f3f589cfa718/schema)