---
title: "Get Tool Registry"
method: GET
path: "/api/public/v2/tool-registry/{identifier}"
tags: ["tool-registry"]
---

# Get Tool Registry

`GET /api/public/v2/tool-registry/{identifier}`

## Path parameters

- `identifier` string, required — Tool ID (numeric) or name

## Query parameters

- `label` string — Resolve version by label name (e.g. production)
- `version` string — Resolve by specific version number

## Response `200`

Successful Response

- object
  - `success` boolean
  - `tool_registry` object
    - `id` integer
    - `name` string
    - `description` string, nullable
    - `workspace_id` integer
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `labels` object[]
    - `version` object, nullable — Resolved version object — includes `tool_definition` and (if set) `execution: { type, language, code }`.
    - `tool_definition` object, nullable

## Other responses

- `401` — Unauthorized - missing or invalid API key.
- `422` — Validation error - request parameters or body are invalid.

---

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