---
title: "Retrieve a finder entity"
method: GET
path: "/v2/finder/{id}"
tags: ["Finder"]
---

# Retrieve a finder entity

`GET /v2/finder/{id}`

Returns a single finder entity by id, scoped to the caller's workspace membership.

## Path parameters

- `id` string, required

## Response `200`

OK

- FinderItem
  - `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/versions/41c02aedc7c0/schema)