---
title: "Convert to order"
method: POST
path: "/cart/convert"
tags: ["Cart"]
---

# Convert to order

`POST /cart/convert`

Convert the current user's cart to an order.

## Response `200`

Cart was converted successfully.

- object
  - `data` Order, required — An order from the Terminal shop.
    - `id` string, required — Unique object identifier. The format and length of IDs may change over time.
    - `index` integer — Zero-based index of the order for this user only.
    - `shipping` object, required — Shipping address of the order.
      - `name` string, required — The recipient's name.
      - `street1` string, required — Street of the address.
      - `street2` string — Apartment, suite, etc. of the address.
      - `city` string, required — City of the address.
      - `province` string — Province or state of the address.
      - `country` string, required — ISO 3166-1 alpha-2 country code of the address.
      - `zip` string, required — Zip code of the address.
      - `phone` string — Phone number of the recipient.
    - `created` string, required — Date the order was created.
    - `amount` object, required — The subtotal and shipping amounts of the order.
      - `shipping` integer, required — Shipping amount of the order, in cents (USD).
      - `subtotal` integer, required — Subtotal amount of the order, in cents (USD).
    - `tracking` object, required — Tracking information of the order.
      - `service` string — Shipping service of the order.
      - `number` string — Tracking number of the order.
      - `url` string — Tracking URL of the order.
      - `status` 'PRE_TRANSIT' | 'TRANSIT' | 'DELIVERED' | 'RETURNED' | 'FAILURE' | 'UNKNOWN' — Current tracking status of the shipment.
      - `statusDetails` string — Additional details about the tracking status.
      - `statusUpdatedAt` string — When the tracking status was last updated.
    - `items` OrderItem[], required — Items in the order.
      - `id` string, required — Unique object identifier. The format and length of IDs may change over time.
      - `description` string — Description of the item in the order.
      - `amount` integer, required — Amount of the item in the order, in cents (USD).
      - `quantity` integer, required — Quantity of the item in the order.
      - `productVariantID` string — ID of the product variant of the item in the order.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `429` — Too Many Requests
- `500` — Internal Server Error

## Changes

- **2025-04-24** `128873249a64` — 6 warning
  - added the new `DELIVERED` enum value to the `data/allOf[#/components/schemas/Order]/tracking/status` response property for the response status `200`
  - added the new `FAILURE` enum value to the `data/allOf[#/components/schemas/Order]/tracking/status` response property for the response status `200`
  - added the new `PRE_TRANSIT` enum value to the `data/allOf[#/components/schemas/Order]/tracking/status` response property for the response status `200`
  - added the new `RETURNED` enum value to the `data/allOf[#/components/schemas/Order]/tracking/status` response property for the response status `200`
  - …2 more
- **2025-04-14** `58fa4af8e325` — 1 info
  - added the required property `data/allOf[#/components/schemas/Order]/created` to the response with the `200` status
- **2025-04-09** `d02e3d898e58` — 3 info
  - added the optional property `data/allOf[#/components/schemas/Order]/tracking/status` to the response with the `200` status
  - added the optional property `data/allOf[#/components/schemas/Order]/tracking/statusDetails` to the response with the `200` status
  - added the optional property `data/allOf[#/components/schemas/Order]/tracking/statusUpdatedAt` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/terminaldotshop/apis/terminal-api/changes/cart/convert/post.md)

---

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