---
title: "List a stash’s items"
method: GET
path: "/v1/workspaces/{workspaceId}/stashes/{id}/items"
tags: ["Stashes"]
---

# List a stash’s items

`GET /v1/workspaces/{workspaceId}/stashes/{id}/items`

## Request

- Base URL: `https://external-api.pirros.com`
- URL: `https://external-api.pirros.com/v1/workspaces/{workspaceId}/stashes/{id}/items`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.pirros.com/oauth/token`

Return the stash’s membership (details and families), keyset-paginated by (sort_order, id) — lifting the 500-item cap of the embedded list in the stash GET. The parent stash is resolved like the stash GET: a cross-workspace, cross-firm, or missing stash returns 404 (no existence disclosure). An empty stash returns an empty list.

## Path parameters

- `workspaceId` string, uuid, required
- `id` string, uuid, required

## Query parameters

- `cursor` string
- `limit` string

## Response `200`

Stash items

- ExternalStashItemListResponse: Cursor-paginated stash membership (lifts the 500-item cap of the stash GET)
  - `response` object, required
    - `data` union[], required
      - union
        - object
          - `item_type` 'detail', required
          - `detail_id` string, uuid, required
          - `family_id` unknown, required
        - object
          - `item_type` 'family', required
          - `detail_id` unknown, required
          - `family_id` string, uuid, required
    - `next_cursor` string, nullable, required
    - `expanded` object, required
  - `meta` object, required
    - `request_id` string, uuid, required

## Other responses

- `400`: Invalid request (bad path param, query param, or cursor)
- `401`: Unauthorized (invalid or missing token)
- `404`: Stash not found in this workspace
- `429`: Rate limit exceeded (1000 requests per hour per client)
- `503`: External API temporarily disabled by operator kill switch (service_unavailable)

---

[API](https://skmtc.dev/pirros/apis/pirros-external-api.md) - [All operations](https://skmtc.dev/pirros/apis/pirros-external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pirros/apis/pirros-external-api/revisions/01c66b8d9fd1?raw)