# Get tool by slug

**Documentation:** /reference/api-reference/tools/getToolsByToolSlug

Retrieve detailed information about a specific tool using its slug identifier. This endpoint returns full metadata about a tool including input/output parameters, versions, and toolkit information.

---

## GET `/api/v3/tools/{tool_slug}`

**Endpoint:** `https://backend.composio.dev/api/v3/tools/{tool_slug}`

**Summary:** Get tool by slug

Retrieve detailed information about a specific tool using its slug identifier. This endpoint returns full metadata about a tool including input/output parameters, versions, and toolkit information.

### Authentication

**ApiKeyAuth** - API Key in `header` header `x-api-key` OR **UserApiKeyAuth** - API Key in `header` header `x-user-api-key`

### Path Parameters

- `tool_slug` (string) *(required)*: The unique slug identifier of the tool

### Query Parameters

- `version` (string): Optional version of the tool to retrieve
- `toolkit_versions` (any): Toolkit version specification. Use "latest" for latest versions or bracket notation for specific versions per toolkit.

### Responses

#### 200 - Successfully retrieved tool details

**Response Schema:**

- `slug` (string) *(required)*: Unique identifier for the tool
- `name` (string) *(required)*: Human-readable display name of the tool
- `description` (string) *(required)*: Detailed explanation of the tool's functionality and purpose
- `toolkit` (object) *(required)*
  - `slug` (string) *(required)*: Unique identifier of the parent toolkit
  - `name` (string) *(required)*: Human-readable name of the parent toolkit
  - `logo` (string) *(required)*: URL to the toolkit logo image
- `input_parameters` (object) *(required)*: Schema definition of required input parameters for the tool
  - `[key: string]` (any)
- `no_auth` (boolean) *(required)*: Indicates if the tool can be used without authentication
- `available_versions` (array<string>) *(required)*: List of all available versions for this tool
- `version` (string) *(required)*: Current version of the tool
- `output_parameters` (object) *(required)*: Schema definition of return values from the tool
  - `[key: string]` (any)
- `scopes` (array<string>) *(required)*: List of scopes associated with the tool
- `tags` (array<string>) *(required)*: List of tags associated with the tool for categorization and filtering
- `human_description` (string): Human-friendly description of the tool, if available
- `is_deprecated` (boolean) *(required)*: Indicates if this tool is deprecated and may be removed in the future
- `deprecated` (object) *(required)*
  - `displayName` (string) *(required)*: The display name of the tool
  - `version` (string) *(required)*: Current version identifier of the tool
  - `available_versions` (array<string>) *(required)*: List of all available versions for this tool
  - `is_deprecated` (boolean) *(required)*: Indicates if this tool is deprecated and may be removed in the future
  - `toolkit` (object) *(required)*
    - `logo` (string) *(required)*: URL to the toolkit logo image

**Example Response:**

```json
{
  "slug": "string",
  "name": "string",
  "description": "string",
  "toolkit": {
    "slug": "string",
    "name": "string",
    "logo": "string"
  },
  "input_parameters": {
    "key": null
  },
  "no_auth": true,
  "available_versions": [
    "string"
  ],
  "version": "string",
  "output_parameters": {
    "key": null
  },
  "scopes": [
    "string"
  ],
  "tags": [
    "string"
  ],
  "human_description": "string",
  "is_deprecated": true,
  "deprecated": {
    "displayName": "string",
    "version": "string",
    "available_versions": [
      "string"
    ],
    "is_deprecated": true,
    "toolkit": {
      "logo": "string"
    }
  }
}
```

#### 400 - Bad request - Invalid tool slug format

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

#### 401 - Unauthorized - Authentication credentials are missing or invalid

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

#### 404 - Not found - Tool with the specified slug does not exist

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

#### 500 - Internal server error - Something went wrong on the server

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

### Example cURL Request

```bash
curl -X GET "https://backend.composio.dev/api/v3/tools/string" \
  -H "x-api-key: YOUR_API_KEY"
```