---
title: GET /v1/tools
description: "List tools — The names-only tool catalogue: each tool's name, display name, category, one-line description, plan tier and whether it runs on a GPU."
full: true
---

**Auth:** required. Send an `ivy_` API key (`Authorization: Bearer ivy_…`), a signed-in session token (`Authorization: Bearer …`) or the session cookie (browser sessions). See [Authentication](/docs/api/authentication).

The names-only tool catalogue: each tool's name, display name, category, one-line description, plan tier and whether it runs on a GPU. Needs an API key or a signed-in session; without one the call returns `401`. Only tools this deployment offers are listed: deprecated, stopped and disabled tools are left out. Tools the agent uses for its own bookkeeping (memory, background tasks, delegation to sub-agents, planning and review) are not listed either.

Parameter schemas are not part of this catalogue; read them from `GET /api/v1/tools/{name}`. Send `If-None-Match` with the last `ETag` to get a `304` when nothing has changed.

## Request

### Headers

- `If-None-Match` (string) —
The `ETag` from an earlier response.

## Responses

### `200` OK

The tool catalogue

Response shape:

- `count` (integer) —

- `generated_at` (string (date-time)) —
When the deployed tool catalog was generated. Fixed per deploy, so every instance returns the same value

- `tools` (object[]) —

### `304` Not Modified

Unchanged since the `If-None-Match` ETag

### `401` Unauthorized

Authentication required

Response shape: `object`

### `429` Too Many Requests

Rate limit exceeded

Response shape: `object`

**curl**

```bash
curl -X GET 'https://ivybiosciences.com/api/v1/tools' \
  -H "Authorization: Bearer $IVY_API_KEY"
```

**JavaScript**

```js
const res = await fetch('https://ivybiosciences.com/api/v1/tools', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${process.env.IVY_API_KEY}`,
  },
});
const data = await res.json();
```

**Python**

```python
import os, requests

res = requests.get(
    "https://ivybiosciences.com/api/v1/tools",
    headers={"Authorization": f"Bearer {os.environ['IVY_API_KEY']}"},
)
data = res.json()
```
