---
title: "GET /item/{itemId}/flat"
method: GET
path: "/item/{itemId}/flat"
tags: ["Work Items and OKRs"]
---

# GET /item/{itemId}/flat

`GET /item/{itemId}/flat`

Get a specific work item metadata by its ID (flattened format)

## Path parameters

- `itemId` string, required

## Query parameters

- `fields` string

## Response `200`

The item’s metadata

- ItemFlat
  - `id` string, nullable
  - `type` string — Workspace-facing type label — the workspace's custom terminology (e.g. "Subtask").
  - `typeKey` string — Canonical type name (requirement/feature/idea/task/bug/epic/product/story/…) — the value the `type` filter and write endpoints accept, independent of workspace terminology.
  - `workspaceId` string
  - `portfolioId` string
  - `shortId` string
  - `title` string
  - `description` string, nullable
  - `creationTime` string, date-time
  - `updateTime` string, date-time
  - `storyPoints` number, double
  - `initiativeId` string, nullable
  - `value` number, double
  - `effort` number, double
  - `kano` string
  - `estimatedHours` number, double
  - `labels` string[]
  - `actualStartDate` string, date-time, nullable
  - `actualEndDate` string, date-time, nullable
  - `devToolKey` DevToolKeyList
    - `jira` string
    - `ado` string
    - `github` string
    - `gitlab` string
    - `pivotaltracker` string
    - `targetprocess` string
  - `webUrl` string — Canonical Craft.io app URL for this item. Computed in PublishService.
  - `status_id` string
  - `status_name` string
  - `importance_id` string
  - `importance_name` string
  - `objective_id` string
  - `objective_name` string
  - `keyResult_id` string
  - `keyResult_name` string
  - `persona_id` string
  - `persona_name` string
  - `sprint_id` string
  - `sprint_name` string
  - `quarter_id` string
  - `quarter_name` string
  - `assignee_id` string
  - `assignee_team` string
  - `assignee_user` string
  - `parent_id` string, nullable
  - `parent_name` string, nullable
  - `parent_shortId` string, nullable
  - `devToolKey_jira` string
  - `devToolKey_ado` string
  - `devToolKey_github` string
  - `devToolKey_gitlab` string
  - `devToolKey_pivotaltracker` string
  - `devToolKey_targetprocess` string
  - `sprint_startDate` string, nullable
  - `sprint_endDate` string, nullable
  - `quarter_startDate` string, nullable
  - `quarter_endDate` string, nullable

## Other responses

- `401` — No access to account
- `403` — Access denied
- `404` — No item found
- `422` — Invalid item ID
- `500` — An error occurred while fetching item

---

[API](https://skmtc.net/craft/apis/craft-io-public-api.md) · [All operations](https://skmtc.net/craft/apis/craft-io-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/craft/craft-io-public-api/versions/2d001661c781/schema)