# Retrieve Purchase Order

Endpoint: GET /organisations/{orgId}/purchase-orders/{purchaseOrderId}
Version: v2_28
Security: ApiKeyAuth

## Path parameters:

  - `purchaseOrderId` (string, required)

  - `orgId` (string, required)
    The organisation identity

## Response 200 fields (application/json):

  - `number` (string, required)
    The purchase order number.

  - `status` (string, required)
    The current status of the purchase order.
    Enum: "OPEN", "APPROVED", "COMPLETED", "CANCELLED"

  - `orderDate` (string)
    The date and time of the purchase order.

  - `expectedDeliveryDate` (string)
    The date and time the delivery is expected to .

  - `supplier` (string)
    The URI of the supplier.

  - `buyer` (string)
    The URI of the buyer.

  - `deliverToLocation` (string)
    The URI of the deliver to location.

  - `lineItems` (array, required)
    List of items included in the purchase order.

  - `lineItems.lineItemId` (string)
    An optional line item id.

  - `lineItems.product` (string, required)
    The URI of the product for the line item included in the purchase order.

  - `lineItems.quantity` (number, required)
    The quantity of the product included in the purchase order.

  - `lineItems.note` (string)
    A note for each line item.

  - `lineItems.productVariant` (string)
    The uri of the product variant if applicable to this purchase order line item.

  - `lineItems.additionalQuantities` (array, required)
    Additiononal quantities can be specified directly on the item.

  - `lineItems.additionalQuantities.baseUnit` (string, required)
    The additional quantity base unit of measurement.

  - `lineItems.additionalQuantities.conversionQuantity` (number, required)
    The additional quantity calculated if the product has a conversion to that base unit.

  - `lineItems.additionalQuantities.overrideQuantity` (number, required)
    An override quantity provided irrespective of whether or not there is a conversion on the product.

  - `note` (string)
    A note to pass any information.

  - `id` (string)
    System assigned or user defined id field.

  - `createdBy` (string)
    User who created the record.

  - `createdTime` (string)
    Date & Time that the record was created.

  - `updatedBy` (string)
    Last updated by user.

  - `updatedTime` (string)
    Date & Time that the record was last updated.


## Response 401 fields

## Response 403 fields

## Response 404 fields

## Response 429 fields

## Response 500 fields