---
title: "List custom tools"
method: GET
path: "/public/v1/tools"
tags: ["Custom Tools"]
---

# List custom tools

`GET /public/v1/tools`

Returns the account's custom tools (API call tools created by the account). WhatsApp template tools are not exposed in this public surface.

## Query parameters

- `filterText` string
- `status` 'ACTIVE' | 'PAUSED'

## Response `200`

A list of tools

- object — Standard list response
  - `results` CustomTool[], required
    - `id` number, required
    - `name` string, required
    - `description` string, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `status` 'PAUSED' | 'ACTIVE' | 'DELETED', nullable
    - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', nullable
    - `url` string, nullable
    - `body` string, nullable
    - `arguments` object[], nullable
      - `name` string, required
      - `description` string, nullable
      - `dataType` 'STRING' | 'NUMBER' | 'DECIMAL' | 'BOOLEAN', required
      - `required` boolean, nullable
      - `defaultValue` string, nullable
    - `headers` object[], nullable
      - `key` string, required
      - `value` string, required
    - `queryParams` object[], nullable
      - `key` string, required
      - `value` string, required
    - `type` 'API_CALL' | 'WHATSAPP_TEMPLATE_MESSAGE', required

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/getfrontline/apis/public-api.md) · [All operations](https://skmtc.net/getfrontline/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getfrontline/public-api/revisions/9d33b6aad674/schema)