---
title: "Get a Transaction"
method: GET
path: "/v3/transactions/{transactionId}"
tags: ["Transaction (v3)"]
---

# Get a Transaction

`GET /v3/transactions/{transactionId}`

Returns the specified Transaction.

## Path parameters

- `transactionId` number, required

## Query parameters

- `expand` 'message'

## Headers

- `orderful-api-key` string, required

## Response `200`

Transaction details.

- TransactionV3Dto
  - `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.

## Other responses

- `404` — Transaction not found.

---

[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)
