---
search:
  tags:
    - Orders
    - GET
seo:
  description: >-
    Retrieves a chronological list of all changes… Reference for the GET
    /api/v1/{team_slug}/{app_slug}/orders/{order_id}/history endpoint in the
    Management API.
sidebar:
  label: Get order history
  badge: GET
title: Get order history
type: openapi-operation
---
Retrieves a chronological list of all changes made to an order, including status transitions, address updates, and line modifications.

`GET /api/v1/{team_slug}/{app_slug}/orders/{order_id}/history`

**Responses**

- `200` — Order history retrieved successfully
- `400` — Invalid order ID format
- `401` — Unauthorized access
- `404` — Order not found
- `500` — Internal server error

Response example, 200:

```json
{
  "data": [
    {
      "change_type": "string",
      "from_status": "string",
      "happened_at": "string",
      "lines": [
        {
          "deleted": true,
          "from_quantity": 0,
          "history_id": "string",
          "order_line_id": "string",
          "product_variant_id": "string",
          "to_quantity": 0
        }
      ],
      "order_id": "string",
      "to_status": "string"
    }
  ],
  "details": [
    "string"
  ],
  "success": true
}
```