> ## 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.

# List tools

> See every API tool on your account.

Returns the API tools on your account, oldest first. Built-in tools like order lookup are not listed. Secret header values are masked.

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

```json 200 theme={null}
{
  "success": true,
  "count": 1,
  "tools": [
    {
      "id": 512,
      "name": "Check stock",
      "description": "Use when the customer asks if an item is in stock.",
      "method": "POST",
      "url": "https://api.yourstore.com/stock",
      "headers": [{ "key": "X-Api-Key", "value": "••••••••", "secret": true }],
      "parameters": [{ "name": "sku", "type": "string", "description": "Item code the customer mentions", "required": true }],
      "presetParameters": [],
      "bodyTemplate": null,
      "bodyFormat": "json",
      "timeoutMs": 10000,
      "speakWhileWaiting": "",
      "createdAt": "2026-10-21T09:30:00.000Z",
      "updatedAt": "2026-10-21T09:30:00.000Z"
    }
  ]
}
```

## Response

**tools** `array`

Your tools. Same fields as [Create a tool](https://api.scalysis.com/api-reference/tools/create.md), plus `id`, `createdAt` and `updatedAt`.

**count** `number`

Number of tools returned.


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