> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Every page is available as Markdown by appending `.md` to its URL; this page is [Markdown](https://www.boxhero.io/docs/zh-cn/developers/api/reference/transactions/get-transaction.md).

# Get a transaction

> Returns a single transaction with its full line items.

Pass `revision` to fetch a specific historical version; omit it to fetch the latest.

`GET https://rest.boxhero-app.com/v1/transactions/{tx_id}`

## 授权

- `Authorization` (string, 必填): `Bearer <token>` 格式的 Bearer 认证请求头，其中 `<token>` 为你的 [API 令牌](https://www.boxhero.io/docs/zh-cn/developers/api/authentication)。

## 路径参数

- `tx_id` (integer, minimum 0, maximum 2147483647, 必填)

## 查询参数

- `revision` (integer, maximum 9007199254740991): Fetch a specific historical revision of this transaction. Omit to fetch the latest revision.

## 响应

**200** The requested transaction with line items.

- `item` (one of, 必填): An inventory transaction with its full line-item detail. Branch on `type` to narrow the variant (e.g. `tx.type === 'move'` makes `tx.from_location` available).

  以下之一

  - `id` (integer, minimum 0, maximum 2147483647, 必填): Transaction id.
  - `to_location` (Entity, 必填): Reference to a related entity (location, partner, or user) embedded in a transaction. The snapshot is captured at transaction time and does not update if the source entity is later renamed or removed.

    - `id` (integer, minimum 0, maximum 2147483647, 必填): Id of the referenced entity.
    - `name` (string, 必填): Display name of the entity at the time the transaction was recorded.
    - `deleted` (boolean, 必填): `true` when the underlying entity has since been deleted. The embedded snapshot is preserved so historical transactions remain readable.
  - `transaction_time` (string, date-time, 必填): Effective time of the transaction. Defaults to the creation time if `tx_time` is omitted on create; change it later by passing `tx_time` on update.
  - `created_at` (string, date-time, 必填): Server-side creation timestamp.
  - `created_by` (Entity, 必填): Reference to a related entity (location, partner, or user) embedded in a transaction. The snapshot is captured at transaction time and does not update if the source entity is later renamed or removed.

    - `id` (integer, minimum 0, maximum 2147483647, 必填): Id of the referenced entity.
    - `name` (string, 必填): Display name of the entity at the time the transaction was recorded.
    - `deleted` (boolean, 必填): `true` when the underlying entity has since been deleted. The embedded snapshot is preserved so historical transactions remain readable.
  - `count_of_items` (integer, minimum -9007199254740991, maximum 9007199254740991, 必填): Number of distinct items in the transaction.
  - `total_quantity` (number, 必填): Signed sum of `quantity` across every item in the transaction. For Move Stock, the sum of the quantities moved to the destination.
  - `url` (string, uri, 必填): Web URL to view this transaction in the BoxHero app.
  - `memo` (string, 必填): Free-text memo. Empty string when not set.
  - `revision` (integer, minimum -9007199254740991, maximum 9007199254740991, 必填): Optimistic-concurrency version. Increments on every update. Pass the current value to update/delete to detect concurrent edits — the operation returns `403` (`/errors/invalid-request` with `code: tx-modify-revision-mismatch`) if the value does not match the server.
  - `type` (string, 必填): 可选值: `in`
  - `partner` (Entity, nullable): Supplier on this Stock In transaction. `null` or absent when no partner was recorded.

    - `id` (integer, minimum 0, maximum 2147483647, 必填): Id of the referenced entity.
    - `name` (string, 必填): Display name of the entity at the time the transaction was recorded.
    - `deleted` (boolean, 必填): `true` when the underlying entity has since been deleted. The embedded snapshot is preserved so historical transactions remain readable.
  - `items` (array of LocationTransactionItem, 必填): Line items recorded by this transaction.

    - `id` (integer, minimum 0, maximum 2147483647, 必填): Item id. **Deprecated** — prefer `item.id`.
    - `name` (string, 必填): Item display name at the time of the transaction (snapshot). **Deprecated** — prefer `item.name`.
    - `sku` (string, 必填): Item SKU. Empty string when unset. **Deprecated** — prefer `item.sku`.
    - `barcode` (string, 必填): Item barcode. Empty string when unset. **Deprecated** — prefer `item.barcode`.
    - `deleted` (boolean, 必填): `true` when the item itself has since been deleted. **Deprecated** — prefer `item.deleted`.
    - `item` (ExtendedItemEntity, 必填): Reference to an item or bundle embedded in order, return, transaction, and bundle component responses.

      - `id` (integer, minimum 0, maximum 2147483647, 必填): Item or bundle id.
      - `name` (string, 必填): Display name.
      - `sku` (string, 必填): SKU. Empty string when unset.
      - `barcode` (string, 必填): Barcode. Empty string when unset.
      - `deleted` (boolean, 必填): Whether the underlying item or bundle is deleted.
    - `quantity` (number, 必填): Signed quantity moved by this line. Positive for Stock In and Move Stock (the quantity arriving at the destination); negative for Stock Out; signed for Adjust Stock.
    - `from_location_new_stock_level` (number): Source-location stock level for this item **after** the transaction. Set only on Move Stock.
    - `to_location_new_stock_level` (number, 必填): Destination-location stock level for this item **after** the transaction.
    - `new_stock_level` (number, 必填): Total on-hand quantity for this item across all locations **after** the transaction.

  - `id` (integer, minimum 0, maximum 2147483647, 必填): Transaction id.
  - `to_location` (Entity, 必填): Reference to a related entity (location, partner, or user) embedded in a transaction. The snapshot is captured at transaction time and does not update if the source entity is later renamed or removed.

    - `id` (integer, minimum 0, maximum 2147483647, 必填): Id of the referenced entity.
    - `name` (string, 必填): Display name of the entity at the time the transaction was recorded.
    - `deleted` (boolean, 必填): `true` when the underlying entity has since been deleted. The embedded snapshot is preserved so historical transactions remain readable.
  - `transaction_time` (string, date-time, 必填): Effective time of the transaction. Defaults to the creation time if `tx_time` is omitted on create; change it later by passing `tx_time` on update.
  - `created_at` (string, date-time, 必填): Server-side creation timestamp.
  - `created_by` (Entity, 必填): Reference to a related entity (location, partner, or user) embedded in a transaction. The snapshot is captured at transaction time and does not update if the source entity is later renamed or removed.

    - `id` (integer, minimum 0, maximum 2147483647, 必填): Id of the referenced entity.
    - `name` (string, 必填): Display name of the entity at the time the transaction was recorded.
    - `deleted` (boolean, 必填): `true` when the underlying entity has since been deleted. The embedded snapshot is preserved so historical transactions remain readable.
  - `count_of_items` (integer, minimum -9007199254740991, maximum 9007199254740991, 必填): Number of distinct items in the transaction.
  - `total_quantity` (number, 必填): Signed sum of `quantity` across every item in the transaction. For Move Stock, the sum of the quantities moved to the destination.
  - `url` (string, uri, 必填): Web URL to view this transaction in the BoxHero app.
  - `memo` (string, 必填): Free-text memo. Empty string when not set.
  - `revision` (integer, minimum -9007199254740991, maximum 9007199254740991, 必填): Optimistic-concurrency version. Increments on every update. Pass the current value to update/delete to detect concurrent edits — the operation returns `403` (`/errors/invalid-request` with `code: tx-modify-revision-mismatch`) if the value does not match the server.
  - `type` (string, 必填): 可选值: `out`
  - `partner` (Entity, nullable): Customer on this Stock Out transaction. `null` or absent when no partner was recorded.

    - `id` (integer, minimum 0, maximum 2147483647, 必填): Id of the referenced entity.
    - `name` (string, 必填): Display name of the entity at the time the transaction was recorded.
    - `deleted` (boolean, 必填): `true` when the underlying entity has since been deleted. The embedded snapshot is preserved so historical transactions remain readable.
  - `items` (array of LocationTransactionItem, 必填): Line items recorded by this transaction.

    - `id` (integer, minimum 0, maximum 2147483647, 必填): Item id. **Deprecated** — prefer `item.id`.
    - `name` (string, 必填): Item display name at the time of the transaction (snapshot). **Deprecated** — prefer `item.name`.
    - `sku` (string, 必填): Item SKU. Empty string when unset. **Deprecated** — prefer `item.sku`.
    - `barcode` (string, 必填): Item barcode. Empty string when unset. **Deprecated** — prefer `item.barcode`.
    - `deleted` (boolean, 必填): `true` when the item itself has since been deleted. **Deprecated** — prefer `item.deleted`.
    - `item` (ExtendedItemEntity, 必填): Reference to an item or bundle embedded in order, return, transaction, and bundle component responses.

      - `id` (integer, minimum 0, maximum 2147483647, 必填): Item or bundle id.
      - `name` (string, 必填): Display name.
      - `sku` (string, 必填): SKU. Empty string when unset.
      - `barcode` (string, 必填): Barcode. Empty string when unset.
      - `deleted` (boolean, 必填): Whether the underlying item or bundle is deleted.
    - `quantity` (number, 必填): Signed quantity moved by this line. Positive for Stock In and Move Stock (the quantity arriving at the destination); negative for Stock Out; signed for Adjust Stock.
    - `from_location_new_stock_level` (number): Source-location stock level for this item **after** the transaction. Set only on Move Stock.
    - `to_location_new_stock_level` (number, 必填): Destination-location stock level for this item **after** the transaction.
    - `new_stock_level` (number, 必填): Total on-hand quantity for this item across all locations **after** the transaction.

  - `id` (integer, minimum 0, maximum 2147483647, 必填): Transaction id.
  - `to_location` (Entity, 必填): Reference to a related entity (location, partner, or user) embedded in a transaction. The snapshot is captured at transaction time and does not update if the source entity is later renamed or removed.

    - `id` (integer, minimum 0, maximum 2147483647, 必填): Id of the referenced entity.
    - `name` (string, 必填): Display name of the entity at the time the transaction was recorded.
    - `deleted` (boolean, 必填): `true` when the underlying entity has since been deleted. The embedded snapshot is preserved so historical transactions remain readable.
  - `transaction_time` (string, date-time, 必填): Effective time of the transaction. Defaults to the creation time if `tx_time` is omitted on create; change it later by passing `tx_time` on update.
  - `created_at` (string, date-time, 必填): Server-side creation timestamp.
  - `created_by` (Entity, 必填): Reference to a related entity (location, partner, or user) embedded in a transaction. The snapshot is captured at transaction time and does not update if the source entity is later renamed or removed.

    - `id` (integer, minimum 0, maximum 2147483647, 必填): Id of the referenced entity.
    - `name` (string, 必填): Display name of the entity at the time the transaction was recorded.
    - `deleted` (boolean, 必填): `true` when the underlying entity has since been deleted. The embedded snapshot is preserved so historical transactions remain readable.
  - `count_of_items` (integer, minimum -9007199254740991, maximum 9007199254740991, 必填): Number of distinct items in the transaction.
  - `total_quantity` (number, 必填): Signed sum of `quantity` across every item in the transaction. For Move Stock, the sum of the quantities moved to the destination.
  - `url` (string, uri, 必填): Web URL to view this transaction in the BoxHero app.
  - `memo` (string, 必填): Free-text memo. Empty string when not set.
  - `revision` (integer, minimum -9007199254740991, maximum 9007199254740991, 必填): Optimistic-concurrency version. Increments on every update. Pass the current value to update/delete to detect concurrent edits — the operation returns `403` (`/errors/invalid-request` with `code: tx-modify-revision-mismatch`) if the value does not match the server.
  - `type` (string, 必填): 可选值: `move`
  - `from_location` (Entity, 必填): Reference to a related entity (location, partner, or user) embedded in a transaction. The snapshot is captured at transaction time and does not update if the source entity is later renamed or removed.

    - `id` (integer, minimum 0, maximum 2147483647, 必填): Id of the referenced entity.
    - `name` (string, 必填): Display name of the entity at the time the transaction was recorded.
    - `deleted` (boolean, 必填): `true` when the underlying entity has since been deleted. The embedded snapshot is preserved so historical transactions remain readable.
  - `items` (array of LocationTransactionItem, 必填): Line items recorded by this transaction.

    - `id` (integer, minimum 0, maximum 2147483647, 必填): Item id. **Deprecated** — prefer `item.id`.
    - `name` (string, 必填): Item display name at the time of the transaction (snapshot). **Deprecated** — prefer `item.name`.
    - `sku` (string, 必填): Item SKU. Empty string when unset. **Deprecated** — prefer `item.sku`.
    - `barcode` (string, 必填): Item barcode. Empty string when unset. **Deprecated** — prefer `item.barcode`.
    - `deleted` (boolean, 必填): `true` when the item itself has since been deleted. **Deprecated** — prefer `item.deleted`.
    - `item` (ExtendedItemEntity, 必填): Reference to an item or bundle embedded in order, return, transaction, and bundle component responses.

      - `id` (integer, minimum 0, maximum 2147483647, 必填): Item or bundle id.
      - `name` (string, 必填): Display name.
      - `sku` (string, 必填): SKU. Empty string when unset.
      - `barcode` (string, 必填): Barcode. Empty string when unset.
      - `deleted` (boolean, 必填): Whether the underlying item or bundle is deleted.
    - `quantity` (number, 必填): Signed quantity moved by this line. Positive for Stock In and Move Stock (the quantity arriving at the destination); negative for Stock Out; signed for Adjust Stock.
    - `from_location_new_stock_level` (number): Source-location stock level for this item **after** the transaction. Set only on Move Stock.
    - `to_location_new_stock_level` (number, 必填): Destination-location stock level for this item **after** the transaction.
    - `new_stock_level` (number, 必填): Total on-hand quantity for this item across all locations **after** the transaction.

  - `id` (integer, minimum 0, maximum 2147483647, 必填): Transaction id.
  - `to_location` (Entity, 必填): Reference to a related entity (location, partner, or user) embedded in a transaction. The snapshot is captured at transaction time and does not update if the source entity is later renamed or removed.

    - `id` (integer, minimum 0, maximum 2147483647, 必填): Id of the referenced entity.
    - `name` (string, 必填): Display name of the entity at the time the transaction was recorded.
    - `deleted` (boolean, 必填): `true` when the underlying entity has since been deleted. The embedded snapshot is preserved so historical transactions remain readable.
  - `transaction_time` (string, date-time, 必填): Effective time of the transaction. Defaults to the creation time if `tx_time` is omitted on create; change it later by passing `tx_time` on update.
  - `created_at` (string, date-time, 必填): Server-side creation timestamp.
  - `created_by` (Entity, 必填): Reference to a related entity (location, partner, or user) embedded in a transaction. The snapshot is captured at transaction time and does not update if the source entity is later renamed or removed.

    - `id` (integer, minimum 0, maximum 2147483647, 必填): Id of the referenced entity.
    - `name` (string, 必填): Display name of the entity at the time the transaction was recorded.
    - `deleted` (boolean, 必填): `true` when the underlying entity has since been deleted. The embedded snapshot is preserved so historical transactions remain readable.
  - `count_of_items` (integer, minimum -9007199254740991, maximum 9007199254740991, 必填): Number of distinct items in the transaction.
  - `total_quantity` (number, 必填): Signed sum of `quantity` across every item in the transaction. For Move Stock, the sum of the quantities moved to the destination.
  - `url` (string, uri, 必填): Web URL to view this transaction in the BoxHero app.
  - `memo` (string, 必填): Free-text memo. Empty string when not set.
  - `revision` (integer, minimum -9007199254740991, maximum 9007199254740991, 必填): Optimistic-concurrency version. Increments on every update. Pass the current value to update/delete to detect concurrent edits — the operation returns `403` (`/errors/invalid-request` with `code: tx-modify-revision-mismatch`) if the value does not match the server.
  - `type` (string, 必填): 可选值: `adjust`
  - `items` (array of LocationTransactionItem, 必填): Line items recorded by this transaction.

    - `id` (integer, minimum 0, maximum 2147483647, 必填): Item id. **Deprecated** — prefer `item.id`.
    - `name` (string, 必填): Item display name at the time of the transaction (snapshot). **Deprecated** — prefer `item.name`.
    - `sku` (string, 必填): Item SKU. Empty string when unset. **Deprecated** — prefer `item.sku`.
    - `barcode` (string, 必填): Item barcode. Empty string when unset. **Deprecated** — prefer `item.barcode`.
    - `deleted` (boolean, 必填): `true` when the item itself has since been deleted. **Deprecated** — prefer `item.deleted`.
    - `item` (ExtendedItemEntity, 必填): Reference to an item or bundle embedded in order, return, transaction, and bundle component responses.

      - `id` (integer, minimum 0, maximum 2147483647, 必填): Item or bundle id.
      - `name` (string, 必填): Display name.
      - `sku` (string, 必填): SKU. Empty string when unset.
      - `barcode` (string, 必填): Barcode. Empty string when unset.
      - `deleted` (boolean, 必填): Whether the underlying item or bundle is deleted.
    - `quantity` (number, 必填): Signed quantity moved by this line. Positive for Stock In and Move Stock (the quantity arriving at the destination); negative for Stock Out; signed for Adjust Stock.
    - `from_location_new_stock_level` (number): Source-location stock level for this item **after** the transaction. Set only on Move Stock.
    - `to_location_new_stock_level` (number, 必填): Destination-location stock level for this item **after** the transaction.
    - `new_stock_level` (number, 必填): Total on-hand quantity for this item across all locations **after** the transaction.

**400** Team is not in LOCATION mode.

- `id` (string, 必填): Unique exception id (`ex_` followed by 32 lowercase hex chars, no dashes — e.g. `ex_8f5c0c8e0e0a4a3c9b3f4f2c4f6c8d2a`). Quote this in support tickets so we can find the request in our logs.
- `type` (string, 必填): Stable, machine-readable error code (RFC 7807-style URI fragment). Branch your error handling on this, not on `title`.

  可选值: `/errors/not-found`, `/errors/invalid-request`, `/errors/invalid-team-mode`, `/errors/tokens/invalid`, `/errors/tokens/required`, `/errors/too-many-requests`, `/errors/core/usage-limit-exceeded`, `/errors/core/forbidden`, `/errors/core/unhandled`, `/errors/unhandled`
- `title` (string, 必填): Human-readable summary of the error, in English.
- `correlationID` (string, 必填): Request correlation id (`rq_` followed by 32 lowercase hex chars, no dashes — e.g. `rq_01abf3...`). Identical to the `X-Correlation-Id` response header. Pass an `X-Correlation-Id` request header to thread your trace through to ours.
- `instance` (string, 必填): Pointer to the specific failing resource (e.g. `/items/12345`). Path-only, no `/v1` version prefix.
- `code` (string): Sub-reason code surfaced from upstream BoxHero core (on core-mapped 4xx) or from the gateway itself (e.g. `not-available-for-api-token` on 403). Use this for fine-grained branching after dispatching on `type`.
- `errors` (array of object): Field-level error details. Present on `/errors/invalid-request` (400) responses. Each entry locates a single failure via JSONPath-like `path` segments and a human-readable `message`.

  - `path` (array of string | number, 必填)
  - `message` (string, 必填)

**401** Missing or invalid API token.

- `id` (string, 必填): Unique exception id (`ex_` followed by 32 lowercase hex chars, no dashes — e.g. `ex_8f5c0c8e0e0a4a3c9b3f4f2c4f6c8d2a`). Quote this in support tickets so we can find the request in our logs.
- `type` (string, 必填): Stable, machine-readable error code (RFC 7807-style URI fragment). Branch your error handling on this, not on `title`.

  可选值: `/errors/not-found`, `/errors/invalid-request`, `/errors/invalid-team-mode`, `/errors/tokens/invalid`, `/errors/tokens/required`, `/errors/too-many-requests`, `/errors/core/usage-limit-exceeded`, `/errors/core/forbidden`, `/errors/core/unhandled`, `/errors/unhandled`
- `title` (string, 必填): Human-readable summary of the error, in English.
- `correlationID` (string, 必填): Request correlation id (`rq_` followed by 32 lowercase hex chars, no dashes — e.g. `rq_01abf3...`). Identical to the `X-Correlation-Id` response header. Pass an `X-Correlation-Id` request header to thread your trace through to ours.
- `instance` (string, 必填): Pointer to the specific failing resource (e.g. `/items/12345`). Path-only, no `/v1` version prefix.
- `code` (string): Sub-reason code surfaced from upstream BoxHero core (on core-mapped 4xx) or from the gateway itself (e.g. `not-available-for-api-token` on 403). Use this for fine-grained branching after dispatching on `type`.
- `errors` (array of object): Field-level error details. Present on `/errors/invalid-request` (400) responses. Each entry locates a single failure via JSONPath-like `path` segments and a human-readable `message`.

  - `path` (array of string | number, 必填)
  - `message` (string, 必填)

**404** No transaction with the given id (and revision, when supplied) was found in this team.

- `id` (string, 必填): Unique exception id (`ex_` followed by 32 lowercase hex chars, no dashes — e.g. `ex_8f5c0c8e0e0a4a3c9b3f4f2c4f6c8d2a`). Quote this in support tickets so we can find the request in our logs.
- `type` (string, 必填): Stable, machine-readable error code (RFC 7807-style URI fragment). Branch your error handling on this, not on `title`.

  可选值: `/errors/not-found`, `/errors/invalid-request`, `/errors/invalid-team-mode`, `/errors/tokens/invalid`, `/errors/tokens/required`, `/errors/too-many-requests`, `/errors/core/usage-limit-exceeded`, `/errors/core/forbidden`, `/errors/core/unhandled`, `/errors/unhandled`
- `title` (string, 必填): Human-readable summary of the error, in English.
- `correlationID` (string, 必填): Request correlation id (`rq_` followed by 32 lowercase hex chars, no dashes — e.g. `rq_01abf3...`). Identical to the `X-Correlation-Id` response header. Pass an `X-Correlation-Id` request header to thread your trace through to ours.
- `instance` (string, 必填): Pointer to the specific failing resource (e.g. `/items/12345`). Path-only, no `/v1` version prefix.
- `code` (string): Sub-reason code surfaced from upstream BoxHero core (on core-mapped 4xx) or from the gateway itself (e.g. `not-available-for-api-token` on 403). Use this for fine-grained branching after dispatching on `type`.
- `errors` (array of object): Field-level error details. Present on `/errors/invalid-request` (400) responses. Each entry locates a single failure via JSONPath-like `path` segments and a human-readable `message`.

  - `path` (array of string | number, 必填)
  - `message` (string, 必填)

**429** Rate limit exceeded. Check `RateLimit`, `Retry-After`, and `X-RateLimit-*` response headers before retrying.

- `id` (string, 必填): Unique exception id (`ex_` followed by 32 lowercase hex chars, no dashes — e.g. `ex_8f5c0c8e0e0a4a3c9b3f4f2c4f6c8d2a`). Quote this in support tickets so we can find the request in our logs.
- `type` (string, 必填): Stable, machine-readable error code (RFC 7807-style URI fragment). Branch your error handling on this, not on `title`.

  可选值: `/errors/not-found`, `/errors/invalid-request`, `/errors/invalid-team-mode`, `/errors/tokens/invalid`, `/errors/tokens/required`, `/errors/too-many-requests`, `/errors/core/usage-limit-exceeded`, `/errors/core/forbidden`, `/errors/core/unhandled`, `/errors/unhandled`
- `title` (string, 必填): Human-readable summary of the error, in English.
- `correlationID` (string, 必填): Request correlation id (`rq_` followed by 32 lowercase hex chars, no dashes — e.g. `rq_01abf3...`). Identical to the `X-Correlation-Id` response header. Pass an `X-Correlation-Id` request header to thread your trace through to ours.
- `instance` (string, 必填): Pointer to the specific failing resource (e.g. `/items/12345`). Path-only, no `/v1` version prefix.
- `code` (string): Sub-reason code surfaced from upstream BoxHero core (on core-mapped 4xx) or from the gateway itself (e.g. `not-available-for-api-token` on 403). Use this for fine-grained branching after dispatching on `type`.
- `errors` (array of object): Field-level error details. Present on `/errors/invalid-request` (400) responses. Each entry locates a single failure via JSONPath-like `path` segments and a human-readable `message`.

  - `path` (array of string | number, 必填)
  - `message` (string, 必填)

请求

**cURL**

```bash
curl --request GET \
  --url 'https://rest.boxhero-app.com/v1/transactions/{tx_id}' \
  --header "Authorization: Bearer $BOXHERO_API_TOKEN"
```

**JavaScript**

```javascript
const response = await fetch("https://rest.boxhero-app.com/v1/transactions/{tx_id}", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.BOXHERO_API_TOKEN}`,
  },
});
const data = await response.json();
```

**Python**

```python
import os
import requests

response = requests.get(
    "https://rest.boxhero-app.com/v1/transactions/{tx_id}",
    headers={
        "Authorization": "Bearer " + os.environ["BOXHERO_API_TOKEN"],
    },
)
data = response.json()
```

**HTTP**

```http
GET /v1/transactions/{tx_id} HTTP/1.1
Host: rest.boxhero-app.com
Authorization: Bearer <token>
```

响应

**200**

```json
{
  "item": {
    "id": 14012345,
    "type": "in",
    "to_location": {
      "id": 47041,
      "name": "Warehouse",
      "deleted": false
    },
    "transaction_time": "2026-01-16T11:00:00.000Z",
    "created_at": "2026-01-16T11:00:00.000Z",
    "created_by": {
      "id": 1001,
      "name": "John Smith",
      "deleted": false
    },
    "count_of_items": 1,
    "total_quantity": 100,
    "url": "https://app.boxhero-app.com/transactions/14012345",
    "memo": "",
    "revision": 1,
    "partner": {
      "id": 431485,
      "name": "Acme Supply Co.",
      "deleted": false
    },
    "items": [
      {
        "id": 14290445,
        "name": "Finish Setting Powder",
        "sku": "SKU-12345678",
        "barcode": "2097678335587",
        "deleted": false,
        "item": {
          "id": 14290445,
          "name": "Finish Setting Powder",
          "sku": "SKU-12345678",
          "barcode": "2097678335587",
          "deleted": false
        },
        "quantity": 100,
        "from_location_new_stock_level": null,
        "to_location_new_stock_level": 220,
        "new_stock_level": 220
      }
    ]
  }
}
```

**400**

```json
{
  "id": "ex_8f5c0c8e-0e0a-4a3c-9b3f-4f2c4f6c8d2a",
  "correlationID": "01J9X8K9XZ4ZWV9T8MQ8B7H7C2",
  "type": "/errors/invalid-team-mode",
  "title": "This API is only available in Location mode. For Basic or Unit mode, please contact support.",
  "instance": "/transactions/12345"
}
```

**401**

```json
{
  "id": "ex_8f5c0c8e-0e0a-4a3c-9b3f-4f2c4f6c8d2a",
  "correlationID": "01J9X8K9XZ4ZWV9T8MQ8B7H7C2",
  "type": "/errors/tokens/required",
  "title": "Missing API token. Provide a Bearer token in the Authorization header.",
  "example": "Bearer wqnot0dlysdg5vymubzi4kiv"
}
```

**404**

```json
{
  "id": "ex_8f5c0c8e-0e0a-4a3c-9b3f-4f2c4f6c8d2a",
  "correlationID": "01J9X8K9XZ4ZWV9T8MQ8B7H7C2",
  "type": "/errors/not-found",
  "title": "No transaction with the given id (and revision, when supplied) was found in this team.",
  "instance": "/transactions/12345"
}
```

**429**

```json
{
  "id": "ex_8f5c0c8e-0e0a-4a3c-9b3f-4f2c4f6c8d2a",
  "correlationID": "01J9X8K9XZ4ZWV9T8MQ8B7H7C2",
  "type": "/errors/too-many-requests",
  "title": "Too many requests.",
  "instance": "/transactions/12345",
  "retryAfter": 60
}
```