Skip to main content
GET
/
v1
/
chat
/
chat
/
sessions
List sessions
curl --request GET \
  --url https://api.agntix.ai/v1/chat/chat/sessions \
  --header 'x-api-key: <api-key>'
{
  "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
  }
}
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_••••"

​
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[]
​
pagination
object