---
title: "List history"
method: GET
path: "/api/v1/history/{id4n}"
tags: ["History"]
---

# List history

`GET /api/v1/history/{id4n}`

Lists the history of a GUID

## Path parameters

- `id4n` string, required

## Query parameters

- `includePrivate` boolean
- `organization` string
- `type` string[]
- `qualifier` string[]
- `fromDate` string, date-time
- `toDate` string, date-time
- `offset` integer
- `limit` integer

## Response `200`

OK

- PaginatedResponseOfHistoryItem
  - `elements` HistoryItem[], required
    - `additionalProperties` object — History items custom additional properties
    - `organizationId` string, required — Originator of the history item
    - `ownerOrganizationId` string — Owner of the history item
    - `sequenceId` integer — Forms the primary key of the history item together with the GUID and the organizationId
    - `timestamp` integer — History item timestamp
    - `type` 'CREATED' | 'DESTROYED' | 'RECYCLED' | 'SHIPMENT_PREPARED' | 'STORED' | 'RETRIEVED_FROM_STORAGE' | 'PACKAGED' | 'DISPATCHED' | 'RECEIVED' | 'DELIVERY_REFUSED' | 'REPROCESSING_STARTED' | 'REPROCESSING_STEP_STARTED' | 'REPROCESSING_STEP_CANCELLED' | 'REPROCESSING_STEP_FINISHED' | 'REPROCESSING_CANCELLED' | 'REPROCESSING_FINISHED' | 'DISASSEMBLED' | 'MAINTENANCE_STARTED' | 'MAINTENANCE_STEP_STARTED' | 'MAINTENANCE_STEP_CANCELLED' | 'MAINTENANCE_STEP_FINISHED' | 'MAINTENANCE_CANCELLED' | 'MAINTENANCE_FINISHED' | 'PRODUCTION_STARTED' | 'PRODUCTION_CANCELLED' | 'PRODUCTION_FINISHED' | 'PRODUCTION_STEP_STARTED' | 'PRODUCTION_STEP_CANCELLED' | 'PRODUCTION_STEP_FINISHED' | 'QUALITY_CHECK_PERFORMED', required — Type of the history item
    - `visibility` Visibility
      - `public` boolean — Document is publicly readable (if ID4N is owned by the same organization)
      - `sharedOrganizationIds` string[] — Document is readable by these organizations (independend of ID4N ownership)
  - `limit` integer, required — The number of returned elements
  - `offset` integer, required — Starting with the n-th element
  - `total` integer — The total number of elements

## Other responses

- `202` — Accepted
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `405` — Method not allowed
- `406` — Not Acceptable
- `415` — Unsupported Media Type
- `500` — Internal Server Error

---

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