---
title: "Get an Acknowledgment"
method: GET
path: "/transactions/{compositeTransactionId}/acknowledgment"
tags: ["Transaction"]
---

# Get an Acknowledgment

`GET /transactions/{compositeTransactionId}/acknowledgment`

## Request

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

Returns the acknowledgment for the specified Transaction.

Use the `id` from the inbound delivery body, or follow its `transaction.acknowledgment.href` directly. Both the sender and the receiver of the Transaction can read the acknowledgment.

A Transaction that has not been acknowledged yet returns `404` — this is the expected response for `NOT_ACKNOWLEDGED`, not an error in your integration.

## Path parameters

- `compositeTransactionId` string, uuid, required

## Headers

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

## Response `200`

Acknowledgment details.

- GetCompositeTransactionAcknowledgmentResponseDto
  - `href` string, required: URL of this acknowledgment resource.
  - `createdAt` string, date-time, required: Acknowledgment creation timestamp.
  - `status` 'ACCEPTED' | 'REJECTED' | 'ACCEPTED_WITH_ERRORS', required: Current acknowledgment status of the Transaction. `ACCEPTED_WITH_ERRORS` is set by Orderful when a 997 reports partial acceptance; you can only set `ACCEPTED` or `REJECTED`.
  - `transaction` CompositeTransactionRefDto, required: Reference to the acknowledged Transaction.
    - `href` string, required: URL of the associated Transaction.
  - `errors` TransactionErrorMessageV3Dto[]: Errors that triggered a rejection, if any.
    - `path` string, required: The path where the error occurred.
    - `code` string, required: Error code.
    - `message` string, required: Error message.

## Other responses

- `403`: Your organization is neither the sender nor the receiver of this Transaction.
- `404`: Transaction not found, the Transaction has not been acknowledged yet, 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/:compositeTransactionId/acknowledgment/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)