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

# List Custom Tools

> Retrieve Custom Tools you've created.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Response

**status** `string`

Whether the requet succeeded or failed.

**tools** `array`

An array of your available tools.

```json Response theme={null}
{
    "status": "success",
    "tools": [
        {
            "tool_id": "TL-5da8347d-0ab7-415d-b156-a7fc5c6074dc",
            "label": null,
            "tool": {
                "name": "BookAppointment",
                "description": "Books the appointment. Can only be used once.",
                "speech": "Please wait while I book that appointment for you",
                "method": "POST",
                "timeout": 99999999,
                "url": "https://...",
                "body": {
                    "slot": "{{input}}"
                },
                "input_schema": {
                    "type": "object",
                    "example": {
                        "date": "2024-03-16",
                        "time": "5:00 PM"
                    },
                    "required": [
                        "date",
                        "time"
                    ],
                    "properties": {
                        "date": "YYYY-MM-DD",
                        "time": "HH:MM (AM|PM)"
                    }
                },
                "response": {
                    "confirmation_message": "$.message"
                }
            },
            "public": false
        },
        ...
    ]
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


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