> ## Documentation Index
> Fetch the complete documentation index at: https://dev.puppetvendors.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Order Timeline

> Get the timeline of events and notes for a specific order

<Note>
  **V2 Preview** — This endpoint is part of the V2 API preview. Breaking changes may occur.
</Note>

## Overview

Return the timeline of events and notes for a specific order. Timeline entries include system events (status changes, fulfillments) and user-added notes.

### Use Cases

* **Order detail page** — Show a chronological activity feed for the order
* **Dispute resolution** — Review the history of communications on an order
* **Audit trail** — Track who did what and when on an order

## Headers

<ParamField header="x-access-token" type="string" required>
  A valid vendor JWT. Requires `orders:read` scope.
</ParamField>

## Path Parameters

<ParamField path="orderId" type="string" required>
  The `_id` of the order.
</ParamField>

## Response

```json 200 theme={null}
{
  "success": true,
  "data": [
    {
      "_id": "664a1b2c3d4e5f6a7b8c9d0e",
      "message": "Order received from Shopify",
      "type": "system",
      "createdBy": "system",
      "createdAt": "2026-05-15T10:30:00Z"
    },
    {
      "_id": "664a1b2c3d4e5f6a7b8c9d0f",
      "message": "Shipped via UPS, tracking #1Z999AA10123456784",
      "type": "note",
      "createdBy": "vendor@example.com",
      "createdAt": "2026-05-16T14:00:00Z",
      "files": [
        {
          "url": "https://cdn.puppetvendors.com/files/shipping-label.pdf",
          "name": "shipping-label.pdf"
        }
      ]
    }
  ]
}
```

### Error Responses

```json 401 theme={null}
{ "success": false, "error": { "message": "Invalid or expired token" } }
```

```json 404 theme={null}
{ "success": false, "error": { "message": "Order not found", "code": "NOT_FOUND" } }
```

## Example

```bash theme={null}
curl -X GET "https://staging-api.puppetvendors.com/orders/507f1f77bcf86cd799439011/timeline" \
  -H "x-access-token: YOUR_VENDOR_JWT"
```