---
title: "POST /orders"
method: POST
path: "/orders"
---

# POST /orders

`POST /orders`

Creates an order for an Outpost.

## Request body

- object
  - `OutpostIdentifier` string, required — The ID or the Amazon Resource Name (ARN) of the Outpost.
  - `LineItems` LineItemRequest[], required — The line items that make up the order.
    - `CatalogItemId` string — The ID of the catalog item.
    - `Quantity` integer — The quantity of a line item request.
  - `PaymentOption` 'ALL_UPFRONT' | 'NO_UPFRONT' | 'PARTIAL_UPFRONT', required — The payment option.
  - `PaymentTerm` 'THREE_YEARS' | 'ONE_YEAR' — The payment terms.

## Response `200`

Success

- CreateOrderOutput
  - `Order` object — Information about this order.
    - `OutpostId` string — The ID of the Outpost in the order.
    - `OrderId` string — The ID of the order.
    - `Status` 'RECEIVED' | 'PENDING' | 'PROCESSING' | 'INSTALLING' | 'FULFILLED' | 'CANCELLED' | 'PREPARING' | 'IN_PROGRESS' | 'COMPLETED' | 'ERROR' — <p>The status of the order.</p> <ul> <li> <p> <code>PREPARING</code> - Order is received and being prepared.</p> </li> <li> <p> <code>IN_PROGRESS</code> - Order is either being built, shipped, or installed. To get more details, see the line item status.</p> </li> <li> <p> <code>COMPLETED</code> - Order is complete.</p> </li> <li> <p> <code>CANCELLED</code> - Order is cancelled.</p> </li> <li> <p> <code>ERROR</code> - Customer should contact support.</p> </li> </ul> <note> <p>The following status are deprecated: <code>RECEIVED</code>, <code>PENDING</code>, <code>PROCESSING</code>, <code>INSTALLING</code>, and <code>FULFILLED</code>. </p> </note>
    - `LineItems` LineItem[] — The line items for the order
      - `CatalogItemId` string — The ID of the catalog item.
      - `LineItemId` string — The ID of the line item.
      - `Quantity` integer — The quantity of the line item.
      - `Status` 'PREPARING' | 'BUILDING' | 'SHIPPED' | 'DELIVERED' | 'INSTALLING' | 'INSTALLED' | 'ERROR' | 'CANCELLED' | 'REPLACED' — The status of the line item.
      - `ShipmentInformation` object — Information about a line item shipment.
        - `ShipmentTrackingNumber` string — The tracking number of the shipment.
        - `ShipmentCarrier` 'DHL' | 'DBS' | 'FEDEX' | 'UPS' — The carrier of the shipment.
      - `AssetInformationList` LineItemAssetInformation[] — Information about assets.
        - `AssetId` string — The ID of the asset.
        - `MacAddressList` MacAddress[] — The MAC addresses of the asset.
      - `PreviousLineItemId` string — The ID of the previous line item.
      - `PreviousOrderId` string — The ID of the previous order.
    - `PaymentOption` 'ALL_UPFRONT' | 'NO_UPFRONT' | 'PARTIAL_UPFRONT' — The payment option for the order.
    - `OrderSubmissionDate` string, date-time — The submission date for the order.
    - `OrderFulfilledDate` string, date-time — The fulfillment date of the order.
    - `PaymentTerm` 'THREE_YEARS' | 'ONE_YEAR' — The payment term.
    - `OrderType` 'OUTPOST' | 'REPLACEMENT' — The type of order.

## Other responses

- `480` — ValidationException
- `481` — ConflictException
- `482` — AccessDeniedException
- `483` — NotFoundException
- `484` — InternalServerException
- `485` — ServiceQuotaExceededException

---

[API](https://skmtc.net/aws/apis/outposts.md) · [All operations](https://skmtc.net/aws/apis/outposts/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/outposts/versions/0530143dffc3/schema)