---
title: "GET /workspace/{workspaceId}/items/flat"
method: GET
path: "/workspace/{workspaceId}/items/flat"
tags: ["Work Items and OKRs"]
---

# GET /workspace/{workspaceId}/items/flat

`GET /workspace/{workspaceId}/items/flat`

Get all workspace working items and OKRs metadata by the workspace ID (flattened format)

## Path parameters

- `workspaceId` string, required

## Query parameters

- `fields` string
- `page` number, double
- `limit` number, double
- `updated_from` string, date-time
- `updated_to` string, date-time
- `type` string
- `parents` string
- `parentId` string
- `keyword` string
- `shortId` string
- `devToolKey` string
- `status` string
- `importance` string
- `assignee` string
- `sprint` string
- `quarter` string
- `labels` string
- `createdBy` string
- `created_from` string, date-time
- `created_to` string, date-time
- `customFields` string

## Response `200`

List of workspace items, OKRS and their metadata

- ItemsPaginatedItemFlat
  - `items` ItemFlat[], required
    - `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
  - `metadata` PaginationMetadata, required
    - `currentPage` number, double, required
    - `perPage` number, double, required
    - `totalPages` number, double, required
    - `totalRecords` number, double, required

## Other responses

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

---

[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)