---
title: "List finder entities"
method: GET
path: "/v2/finder"
tags: ["Finder"]
---

# List finder entities

`GET /v2/finder`

Returns all finder entities for the current workspace. Owned entities are scoped to the active project; structural entities and skills remain workspace-wide.

## Response `200`

OK

- ListFinderEntitiesResponse
  - `object` string, required — Object discriminator for list responses; always `list`.
  - `data` FinderItem[], required — All finder entities visible to the caller. Not paginated.
    - `id` string — Unique entity identifier. Serialized as `_id` for parity with the finder collection and the frontend FinderItem shape.
    - `type` string, required — Discriminator for the heterogeneous finder collection, e.g. "project", "directory", "skill", "prompt", "agent", "dataset".
    - `display_name` string, required — Human-readable name shown in the navigation tree.
    - `description` string — Optional description of the entity.
    - `workspace_id` string, required — Workspace that owns the entity.
    - `project_id` string — Project the entity belongs to. Null for structural roots (projects).
    - `parent_id` string — Parent finder node (directory or project). Null for roots.
    - `key` string — Optional stable key used by some entity types (e.g. tools).
    - `created_by_id` string — Identifier of the user who created the entity.
    - `updated_by_id` string — Identifier of the user who last updated the entity.
    - `metadata` object — Free-form metadata stored with the entity.
    - `created_at` string — ISO timestamp for when the entity was created.
    - `updated_at` string — ISO timestamp for when the entity was last updated.

---

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