List Sessions

GET

chat

sessions

List sessions

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

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

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

{
  "data": [
    {
      "id": "ses_01j3m8xkqp8v2nw4f7g9hk0r",
      "agentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "platform": "SDK",
      "state": "OPEN",
      "metadata": {},
      "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/chat/sessions?agentId=a1b2c3d4-e5f6-7890-abcd-ef1234567890&state=OPEN&limit=20" \
  -H "x-api-key: pk_live_••••"

const params = new URLSearchParams({
  agentId: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
  state: 'OPEN',
  page: '1',
  limit: '20',
});

const { data, pagination } = await fetch(
  `https://api.agntix.ai/v1/chat/chat/sessions?${params}`,
  { headers: { 'x-api-key': 'pk_live_••••' } },
).then(r => r.json());

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

import httpx

result = httpx.get(
    "https://api.agntix.ai/v1/chat/chat/sessions",
    headers={"x-api-key": "pk_live_••••"},
    params={
        "agentId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "state": "OPEN",
        "page": 1,
        "limit": 20,
    },
).json()

sessions = result["data"]
print(f"{result['pagination']['total']} sessions found")

Sample response

{
  "data": [
    {
      "id": "ses_01j3m8xkqp8v2nw4f7g9hk0r",
      "agentId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "platform": "SDK",
      "state": "OPEN",
      "metadata": { "userId": "usr_123" },
      "createdAt": "2026-04-29T09:00:00Z",
      "updatedAt": "2026-04-29T09: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

agentId

string<uuid>

Filter by agent.

state

enum<string>

Filter by session state.

Available options:

OPEN,

CLOSED

platform

enum<string>

Filter by originating platform.

Available options:

SDK,

WEB,

WHATSAPP,

VOICE

Response

Paginated list of sessions.

data

object[]

Show child attributes

pagination

object

Show child attributes

List sessions

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

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

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

{
  "data": [
    {
      "id": "ses_01j3m8xkqp8v2nw4f7g9hk0r",
      "agentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "platform": "SDK",
      "state": "OPEN",
      "metadata": {},
      "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