List Tools

GET

chat

tools

List tools

curl --request GET \
  --url https://api.agntix.ai/v1/chat/tools \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.agntix.ai/v1/chat/tools', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "GET_ACCOUNT_BALANCE",
      "description": "<string>",
      "ajvPropertiesSchema": {},
      "orgId": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 47,
    "totalPages": 3
  }
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Authentication required.",
    "status": 401
  },
  "meta": {
    "requestId": "req_01j3m...",
    "timestamp": "2026-04-29T10:00:00Z"
  }
}

Every endpoint on this page requires either a Clerk-issued JWT (Authorization: Bearer <token>) or an organization API key (x-api-key: pk_…). Anonymous calls return 401 Unauthorized. See Authentication for the full setup.

Code examples

curl "https://api.agntix.ai/v1/chat/tools?page=1&limit=20" \
  -H "x-api-key: pk_live_••••"

curl "https://api.agntix.ai/v1/chat/tools?type=API_TOOL&search=balance" \
  -H "x-api-key: pk_live_••••"

const { data: tools, pagination } = await fetch(
  'https://api.agntix.ai/v1/chat/tools?page=1&limit=20',
  { headers: { 'x-api-key': 'pk_live_••••' } },
).then(r => r.json());

console.log(`${pagination.total} tools found`);

import httpx

result = httpx.get(
    "https://api.agntix.ai/v1/chat/tools",
    headers={"x-api-key": "pk_live_••••"},
    params={"page": 1, "limit": 20, "type": "API_TOOL"},
).json()

for tool in result["data"]:
    print(f"{tool['name']} ({tool['type']})")

Sample response

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "GET_ACCOUNT_BALANCE",
      "description": "Retrieves the current account balance.",
      "type": "API_TOOL",
      "orgId": "org_2abc123",
      "createdAt": "2026-04-28T10:00:00Z",
      "updatedAt": "2026-04-28T10:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1
  }
}

Authorizations

x-api-key

string

header

required

Organization API key. Obtain from the dashboard. Format: pk_live_…

Query Parameters

page

integer

default:1

limit

integer

default:20

Required range: x <= 100

type

enum<string>

Filter by tool type.

Available options:

API_TOOL,

FUNCTION_TOOL

string

Search by tool name.

Response

Paginated list of tools.

data

object[]

Show child attributes

pagination

object

Show child attributes

List tools

curl --request GET \
  --url https://api.agntix.ai/v1/chat/tools \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.agntix.ai/v1/chat/tools', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "GET_ACCOUNT_BALANCE",
      "description": "<string>",
      "ajvPropertiesSchema": {},
      "orgId": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 47,
    "totalPages": 3
  }
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Authentication required.",
    "status": 401
  },
  "meta": {
    "requestId": "req_01j3m...",
    "timestamp": "2026-04-29T10:00:00Z"
  }
}

Overview

Agents

Chat

Voice

Tools

Phone Numbers

Code examples

Sample response

Authorizations

Query Parameters

Response

​Code examples

​Sample response

Authorizations

Query Parameters

Response

Code examples

Sample response