<!-- Source: https://docs.vinsi.ai/api-docs/tool-id -->
# Get Tool by ID

Fetch a tool by ID. configuration is returned as a parsed object. Returns 404 if the tool does not exist and 403 if it belongs to another organization.

```http
GET https://dashboard.vinsi.ai/api/tools/{toolId}
```

## Authentication

Send your API key in the `x-api-key` header. Create keys in the VINSI dashboard under Settings → API Keys.

## Headers

| Name | Type | Required |
|---|---|---|
| Content-Type | string | yes (application/json) |
| x-api-key | string | yes |

## Path parameters

| Name | Example |
|---|---|
| toolId | cmexampletool000000000001 |

## Example request

```bash
curl -X GET 'https://dashboard.vinsi.ai/api/tools/cmexampletool000000000001' \
  -H 'x-api-key: YOUR_API_KEY'
```

## Example response

```json
{
  "id": "cmexampletool000000000001",
  "name": "example-tool",
  "description": "example tool description",
  "type": "TransferCall",
  "configuration": {
    "phoneNumber": "+18001234567",
    "transferMessage": "transfer message"
  },
  "createdAt": "2026-01-27T16:15:42.751Z",
  "updatedAt": "2026-01-27T16:15:42.751Z",
  "userId": "cmexampleuser0000000000001",
  "organizationId": "cmexampleorg00000000000001",
  "dtmfOnly": null
}
```