---
title: "Retrieve the Turn History on a Workflow"
method: GET
path: "/workflows/{id}/turn-history"
tags: ["Workflows"]
---

# Retrieve the Turn History on a Workflow

`GET /workflows/{id}/turn-history`

An array of objects for each turn on a workflow. 

**OAuth Scope required:** `public.workflows.readTurnHistory`

## Path parameters

- `id` string, required

## Query parameters

- `page` integer
- `pageSize` integer

## Headers

- `x-as-user-email` string
- `x-as-user-id` string

## Response `200`

200

- object
  - `page` integer
  - `pageSize` integer
  - `count` integer
  - `list` object[]
    - `turnParty` string
    - `turnStartTime` string
    - `turnLocation` string
    - `turnUserId` string
    - `turnEndTime` string
    - `turnNumber` integer
    - `turnUserEmail` string

## Other responses

- `403` — 403
- `404` — 404

---

[API](https://skmtc.net/ironcladapp/apis/ironclad-public-api.md) · [All operations](https://skmtc.net/ironcladapp/apis/ironclad-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ironcladapp/ironclad-public-api/versions/9459b4cfc1e0/schema)