---
title: "GET /api/cascade-tracing/documents/{id}/purchase-order"
method: GET
path: "/api/cascade-tracing/documents/{id}/purchase-order"
tags: ["Order Tracing - Documents"]
---

# GET /api/cascade-tracing/documents/{id}/purchase-order

`GET /api/cascade-tracing/documents/{id}/purchase-order`

## Request

- Base URL: `https://api.retraced.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.retraced.com/api/cascade-tracing/documents/{id}/purchase-order`
- Auth: none declared

The purchase order a tracing document belongs to, with the sales orders that replacing or deleting the document would also affect: those linked to the purchase order, then its own sales order last. A document attached through links resolves to the purchase order supplied from those links' origin node. 404 when the document, the purchase order or its own sales order is missing or removed; 422 (`document_is_origin_order`) when the document hangs off an origin-country link. Not scoped to the caller's company.

## Path parameters

- `id` string, required

## Response `200`

Default Response

- object
  - `metadata` object, required
    - `success` boolean, required: True when the request succeeded.
  - `data` object, required
    - `tracingDocument` object, required
      - `id` string, required
      - `name` string, required
      - `type` string, nullable, required
      - `fileName` string, nullable, required
      - `fileContentType` string, nullable, required
      - `fileUrl` string, nullable, required
      - `updatedByUserName` string, nullable, required
      - `fileData` object, required
        - `previewUrl` string, nullable, required
    - `tracingPurchaseOrder` object, required
      - `id` string, required
      - `orderNumber` string, nullable, required
      - `buyerCompanyId` string, nullable, required
      - `buyerCompany` object, nullable, required
        - `name` string, nullable, required
      - `supplierCompanyId` string, nullable, required
      - `supplierCompany` object, nullable, required
        - `name` string, nullable, required
      - `totalUploadedDocumentTypes` number, nullable, required
      - `totalRequiredDocumentTypes` number, nullable, required
      - `lastProductionProcessName` string, nullable, required
      - `color` string, nullable, required
      - `depthLevel` number, nullable, required
    - `tracingLinks` object[], required
      - `id` string, required
      - `buyerCompanyId` string, nullable, required
      - `buyerCompany` object, nullable, required
        - `name` string, nullable, required
      - `supplierCompanyId` string, nullable, required
      - `supplierCompany` object, nullable, required
        - `name` string, nullable, required

## Other responses

- `401`: Default Response
- `403`: Default Response
- `404`: Default Response
- `422`: Default Response

## Changes

> 108 revisions in range; 2 not diffed.

- **2026-10-09** `ddfec192e804`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/retraced/apis/api-reference/changes/api/cascade-tracing/documents/:id/purchase-order/get.md)

---

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