> ## Documentation Index
> Fetch the complete documentation index at: https://api.scalysis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a tool

> Read one API tool.

Returns one tool. Secret header values are masked.

## Path

**id** `number` *required*

Tool ID from [Create a tool](https://api.scalysis.com/api-reference/tools/create.md) or [List tools](https://api.scalysis.com/api-reference/tools/list.md).

```bash cURL theme={null}
curl https://app.scalysis.com/api/v1/tools/512 \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```json 200 theme={null}
{
  "success": true,
  "tool": {
    "id": 512,
    "name": "Check stock",
    "method": "POST",
    "url": "https://api.yourstore.com/stock",
    "headers": [{ "key": "X-Api-Key", "value": "••••••••", "secret": true }],
    "timeoutMs": 10000
  }
}
```

```json 404 theme={null}
{
  "success": false,
  "error": "Tool not found.",
  "error_code": "TOOL_NOT_FOUND"
}
```

## Response

**tool** `object`

Same fields as [Create a tool](https://api.scalysis.com/api-reference/tools/create.md). Shortened in the example.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.