---
title: "List Transactions"
method: GET
path: "/v3/transactions"
tags: ["Transaction (v3)"]
---

# List Transactions

`GET /v3/transactions`

Returns an array of Transactions sorted in descending order by their creation date. A maximum of 100 Transactions will be returned at a time.

## Query parameters

- `prevCursor` string
- `nextCursor` string
- `createdAt` string
- `stream` string[]
- `businessNumber` string[]
- `transactionType` string[]
- `validationStatus` string[]
- `deliveryStatus` string[]
- `acknowledgmentStatus` string[]
- `senderIsaId` string[]
- `receiverIsaId` string[]
- `referenceIdentifier` string
- `senderInterchangeReferenceIdentifier` string
- `senderGroupReferenceIdentifier` string
- `senderTransactionReferenceIdentifier` string
- `receiverInterchangeReferenceIdentifier` string
- `receiverGroupReferenceIdentifier` string
- `receiverTransactionReferenceIdentifier` string

## Headers

- `orderful-api-key` string, required

## Response `200`

List of transactions.

- ListTransactionsResponseV3Dto
  - `metadata` ListTransactionsResponseV3MetadataDto, required
    - `pagination` PaginationV3
      - `links` PaginationLinkV3, required
        - `next` string, nullable, required — Next URL which you can use to fetch the next page.
        - `prev` string, nullable, required — Previous URL which you can use to fetch the previous page.
  - `data` TransactionV3Dto[], required — List of transactions.
    - `id` string, required — Transaction ID.
    - `href` string, required — Transaction URL.
    - `version` 'v3', required
    - `sender` TransactionIdentityV3Dto, required
      - `isaId` string, required — ISA ID for production.
      - `isaIdQualifier` string, required — ISA ID qualifier.
      - `testIsaId` string, required — ISA ID for test stream.
      - `testIsaIdQualifier` string, required — Test ISA ID qualifier.
      - `name` string, required — EDI account name.
    - `receiver` TransactionIdentityV3Dto, required
      - `isaId` string, required — ISA ID for production.
      - `isaIdQualifier` string, required — ISA ID qualifier.
      - `testIsaId` string, required — ISA ID for test stream.
      - `testIsaIdQualifier` string, required — Test ISA ID qualifier.
      - `name` string, required — EDI account name.
    - `type` TransactionTypeV3Dto, required
      - `name` string, required — Transaction type name (e.g., 850_PURCHASE_ORDER).
    - `stream` 'TEST' | 'LIVE', required
    - `businessNumber` string, required — Business identifier for the transaction.
    - `referenceIdentifiers` TransactionReferenceIdentifierV3Dto[], required — Reference identifiers for the transaction.
      - `value` string, required — Reference identifier value.
      - `type` 'INTERCHANGE' | 'GROUP' | 'TRANSACTION', required — Reference identifier type.
      - `owner` 'SENDER' | 'RECEIVER', required — Owner of the reference identifier.
    - `message` object, required — Transaction message. Contains an href link to the message content. When expand=message is used, the full transactionSets array is included.
    - `validationStatus` 'PROCESSING' | 'VALID' | 'INVALID', required — Validation status of the transaction.
    - `deliveryStatus` 'PENDING' | 'SENT' | 'DELIVERED' | 'FAILED', required — Delivery status of the transaction.
    - `acknowledgmentStatus` 'NOT_ACKNOWLEDGED' | 'ACCEPTED' | 'REJECTED' | 'OVERDUE' | 'ACCEPTED_WITH_ERRORS', required — Acknowledgment status of the transaction.
    - `createdAt` string, date-time, required — Datetime the transaction was created.
    - `lastUpdatedAt` string, date-time, required — Datetime the transaction was last updated.
    - `acknowledgment` TransactionAcknowledgmentRefV3Dto, required
      - `href` string, required — Acknowledgment URL.

---

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