---
title: "gets parcel state history"
method: GET
path: "/api/v{version}/parcels/{parcelId}/state-history"
tags: ["orders"]
---

# gets parcel state history

`GET /api/v{version}/parcels/{parcelId}/state-history`

gets parcel state history. Permissions requises : SupplierAdminRole, SupplierParcelsManagerRole.

## Path parameters

- `version` string, required
- `parcelId` string, uuid, required

## Headers

- `X-Tenant` string, required

## Response `200`

OK

- ParcelStateHistoryDto[]
  - `id` string, uuid
  - `createdAt` string, date-time
  - `previousState` StateDto
    - `id` string, uuid
    - `name` string, nullable
    - `description` string, nullable
    - `isBlocking` boolean, nullable
    - `isLocked` boolean, nullable
    - `visibleFor` 0 | 1 | 2 | 4 | 8
    - `editableBy` 0 | 1 | 2 | 4 | 8
    - `color` string, nullable
  - `newState` StateDto
    - `id` string, uuid
    - `name` string, nullable
    - `description` string, nullable
    - `isBlocking` boolean, nullable
    - `isLocked` boolean, nullable
    - `visibleFor` 0 | 1 | 2 | 4 | 8
    - `editableBy` 0 | 1 | 2 | 4 | 8
    - `color` string, nullable
  - `modifiedBy` UserSnapshot
    - `id` string, uuid
    - `fullName` string, nullable
  - `location` LocationSnapshot
    - `hubId` string, uuid, nullable
    - `hubName` string, nullable
    - `hubCity` string, nullable
    - `hubDistrict` string, nullable
    - `type` string, nullable
    - `membership` string, nullable
    - `hubTerritoryCityId` string, uuid, nullable
  - `arrivalHub` HubSnapshot
    - `hubId` string, uuid, nullable
    - `hubName` string, nullable
    - `hubCity` string, nullable
    - `hubCityTerritoryId` string, uuid, nullable
    - `hubDistrict` string, nullable
    - `hubDistrictTerritoryId` string, uuid, nullable
    - `hubType` string, nullable
  - `comment` string, nullable
  - `situations` ParcelStateSituationHistoryDto[], nullable
    - `situationName` string, nullable
    - `situationSlug` string, nullable
    - `situationDescription` string, nullable
    - `createdAt` string, date-time
    - `modifiedBy` UserSnapshot
      - `id` string, uuid
      - `fullName` string, nullable
    - `metadata` object, nullable

---

[API](https://skmtc.net/zrexpress/apis/zrexpress-api.md) · [All operations](https://skmtc.net/zrexpress/apis/zrexpress-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zrexpress/zrexpress-api/revisions/99b075e0b641/schema)