---
title: "Retrieve a specific purchase order by ID"
method: GET
path: "/purchase-orders/{id}"
tags: ["purchaseOrders"]
---

# Retrieve a specific purchase order by ID

`GET /purchase-orders/{id}`

Returns detailed information for a single purchase order including all line items.

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required
- `X-Api-Key` string, required
- `X-API-Version` string

## Response `200`

Successful response with purchase order details

- PurchaseOrderDetail
  - `version` string
  - `purchase_order` PurchaseOrderDetailPurchaseOrder, required
    - `id` string, required
    - `external_id` string
    - `po_number` string
    - `status` 'pending' | 'open' | 'received' | 'closed' | 'flagged' | 'archived' | 'deleted', required
    - `ottimate_location_id` integer
    - `ottimate_company_id` integer
    - `date` string, date
    - `erp_vendor_id` string
    - `erp_vendor_name` string
    - `total_amount` number, double
    - `tax` number, double
    - `freight` number, double
    - `miscellaneous_charges` number, double
    - `invoice_number_ref` string
    - `is_2_way` boolean
    - `items` PurchaseOrderDetailPurchaseOrderItemsItems[]
      - `id` string
      - `external_id` string
      - `name` string
      - `sku` string
      - `quantity` number, double
      - `price` number, double
      - `uom` string
      - `dimensions` PurchaseOrderDetailPurchaseOrderItemsItemsDimensions — Resolved dimensions keyed by dimension type. Each value is an object containing the dimension's id, erp_dimension_id, name, and code — unlike the POST/PATCH request format which expects plain string values.
      - `created_date` string, date-time
      - `created_date_utc` string, date-time, nullable — UTC equivalent of created_date. ISO 8601 with Z suffix, e.g. "2025-05-20T15:17:35.652584Z".
      - `last_modified_date` string, date-time
      - `last_modified_date_utc` string, date-time, nullable — UTC equivalent of last_modified_date. ISO 8601 with Z suffix, e.g. "2025-05-20T15:17:35.652584Z".
    - `created_date` string, date-time
    - `created_date_utc` string, date-time, nullable — UTC equivalent of created_date. ISO 8601 with Z suffix, e.g. "2025-05-20T15:17:35.652584Z".
    - `last_modified_date` string, date-time
    - `last_modified_date_utc` string, date-time, nullable — UTC equivalent of last_modified_date. ISO 8601 with Z suffix, e.g. "2025-05-20T15:17:35.652584Z".
    - `custom_fields` PurchaseOrderDetailPurchaseOrderCustomFields — Custom fields configured for this company's purchase orders

## Other responses

- `403` — Forbidden - Access denied or insufficient permissions
- `404` — Not found - Resource does not exist

---

[API](https://skmtc.dev/ottimate/apis/api-reference.md) · [All operations](https://skmtc.dev/ottimate/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ottimate/api-reference/revisions/ba91ff4c6969/schema)