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

# Get a Transaction

`GET /transactions/{transactionId}`

## Request

- Base URL: `https://api.orderful.com`
- URL: `https://api.orderful.com/transactions/{transactionId}`
- Auth: API key in header `orderful-api-key`
- TypeScript: <https://skmtc.dev/orderful/apis/orderful-api/docs/transactions/:transactionId/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the specified Transaction in the same shape as each item of <a href="https://docs.orderful.com/reference/transactionv4controller_listtransactions" target="_blank">List Transactions</a>.

The response's `links` object carries ready-built URLs to this Transaction's <a href="https://docs.orderful.com/reference/compositetransactioncontroller_getacknowledgment" target="_blank">acknowledgment</a> and <a href="https://docs.orderful.com/reference/transactionv4controller_getmessage" target="_blank">message content</a>.

## Path parameters

- `transactionId` string, uuid, required

## Headers

- `orderful-api-key` string, required
- `orderful-api-version` string, required

## Response `200`

Transaction details.

- TransactionV4Dto: A Transaction in the public v4 shape.
  - `id` string, uuid, required: The Transaction's unique ID. This is the same value delivered as `id` in an inbound delivery payload, and the value the v4 transaction endpoints take as their path parameter.
  - `direction` 'in' | 'out', required: Whether the transaction was received (`in`) or sent (`out`) by your organization.
  - `senderId` string, required: ISA ID of the party that sent the transaction.
  - `receiverId` string, required: ISA ID of the party that received the transaction.
  - `ediTransactionType` string, required: The full Orderful transaction type identifier, for example `850_PURCHASE_ORDER` or the EDIFACT `ORDERS_PURCHASE_ORDER`. See <a href="https://docs.orderful.com/reference/available-transaction-types" target="_blank">Available Transaction Types</a>.
  - `simplifiedTransactionType` 'PURCHASE_ORDER' | 'PURCHASE_ORDER_ACKNOWLEDGMENT' | 'PURCHASE_ORDER_CHANGE' | 'SHIP_NOTICE' | 'INVOICE' | 'INVENTORY_ADVICE' | 'PRICE_SALES_CATALOG' | 'WAREHOUSE_SHIPPING_ORDER' | 'WAREHOUSE_SHIPPING_ADVICE' | 'WAREHOUSE_STOCK_TRANSFER_SHIPMENT' | 'WAREHOUSE_STOCK_TRANSFER_RECEIPT', nullable, required: Business name shared by every EDI transaction type that carries the same document, for example `INVOICE` for both `810_INVOICE` and `INVOIC_INVOICE`. `null` for any transaction type that has no alias — check for `null` rather than assuming a value is present. For the full mapping, see <a href="https://docs.orderful.com/reference/mosaic-schemas" target="_blank">Mosaic Schemas</a>.
  - `stream` 'test' | 'live', required: Whether the transaction belongs to the test or the live stream.
  - `validationStatus` 'PROCESSING' | 'VALID' | 'INVALID', required: Whether the transaction message passed guideline validation.
  - `deliveryStatus` 'PENDING' | 'SENT' | 'DELIVERED' | 'FAILED', required: How far the transaction has progressed towards its recipient.
  - `acknowledgmentStatus` 'NOT_ACKNOWLEDGED' | 'ACCEPTED' | 'REJECTED' | 'OVERDUE' | 'ACCEPTED_WITH_ERRORS', required: Whether the recipient has acknowledged the transaction.
  - `businessNumber` string, nullable, required: Identifier the document carries in your business, for example an invoice or purchase order number.
  - `createdAt` string, date-time, required: When the transaction was created.
  - `links` TransactionV4LinksDto, required
    - `self` string, uri, required: URL of this transaction resource.
    - `acknowledgment` string, uri, required: URL of this transaction's acknowledgment.
    - `message` string, uri, required: URL of this transaction's message content.

## Other responses

- `400`: The `transactionId` is not a UUID.
- `403`: Your organization is not authorized to read Transactions.
- `404`: Transaction not found, it belongs to another organization, or the `orderful-api-version: v4` header is missing.

## Changes

- **2026-11-03** `fe0e82430746`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/orderful/apis/orderful-api/changes/transactions/:transactionId/get.md)

---

[API](https://skmtc.dev/orderful/apis/orderful-api.md) - [All operations](https://skmtc.dev/orderful/apis/orderful-api/llms.txt) - [OpenAPI document](https://skmtc.dev/orderful/apis/orderful-api/revisions/fe0e82430746?raw)