---
title: "Inspect a tool"
method: GET
path: "/tools/{id}"
tags: ["Tools"]
---

# Inspect a tool

`GET /tools/{id}`

## Request

- Base URL: `https://api.orcarouter.ai/v1`
- URL: `https://api.orcarouter.ai/v1/tools/{id}`
- Auth: HTTP bearer

One tool with its input schema, price and health. Free. Build a
run's `input` from `input_schema`.

## Path parameters

- `id` string, required

## Response `200`

OK

- object
  - `success` boolean
  - `data` ToolDetail
    - `id` string
    - `provider` string
    - `provider_label` string
    - `display_name` string
    - `summary` string
    - `categories` string[]
    - `tier` 'verified' | 'bridged' | 'community'
    - `score` number: Relevance to `q`. Present only on a query.
    - `price` ToolPrice
      - `mode` 'per_call' | 'per_result' | 'per_unit'
      - `unit` string
      - `for_sale` boolean: Always `true` on discover and inspect; tools without a price are not listed.
      - `sell_usd` number: What you pay per call or per unit, all-in.
      - `est_usd_for` object
        - `units` number
        - `usd` number
    - `health` ToolHealth
      - `verdict` 'healthy' | 'stable' | 'degraded' | 'outage' | 'unknown'
      - `ok` boolean, nullable
      - `success_7d` number, nullable
      - `p50_ms` integer, nullable
      - `p50_sample_size` integer
      - `last_probe_at` integer, nullable: Unix seconds.
    - `runs_30d` integer
    - `idempotent` boolean: Repeating a call has no extra effect, so failed runs are safe to retry.
    - `version` integer
    - `input_schema` object: JSON Schema (draft 2020-12 subset) a run's `input` is validated against.
    - `endpoint` object
      - `method` string
      - `base_url` string
      - `path` string
    - `data_class` 'public' | 'personal' | 'scraped' | 'financial' | 'unclassified'
    - `tos_url` string

## Other responses

- `404`: A Tools error. Branch on `code`. Refusals from the authentication layer have no `success` or `code`; see [Errors](/agent-infra/tools/errors).

## Changes

- **2026-11-03** `80ba8288c51d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/orcarouter/apis/orcarouter-api/changes/tools/:id/get.md)

---

[API](https://skmtc.dev/orcarouter/apis/orcarouter-api.md) - [All operations](https://skmtc.dev/orcarouter/apis/orcarouter-api/llms.txt) - [OpenAPI document](https://skmtc.dev/orcarouter/apis/orcarouter-api/revisions/80ba8288c51d?raw)