---
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.
  - `icon_url` string — Optional logo or image URL shown for this entity.

## Changes

> 271 revisions in range; 82 not diffed.

- **2026-09-01** `359a7831a2f0` — 1 info
  - added the optional property `icon_url` to the response with the `200` status
- **2026-09-01** `66b8a4902911` — 1 warning
  - removed the optional property `icon_url` from the response with the `200` status
- **2026-09-01** `081200e02fe0` — 1 info
  - added the optional property `icon_url` to the response with the `200` status
- **2026-08-31** `b22330eb2d5a` — 1 warning
  - removed the optional property `icon_url` from the response with the `200` status
- **2026-08-31** `3a2f6c296c09` — 1 info
  - added the optional property `icon_url` to the response with the `200` status

[Full history](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/finder/:id/get.md)

---

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