---
title: "Get Agent Usage Sessions"
method: GET
path: "/api/agents/{agent_id}/usage/sessions"
tags: ["agent-usage"]
---

# Get Agent Usage Sessions

`GET /api/agents/{agent_id}/usage/sessions`

## Request

- Base URL: `https://api.tintin-x.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tintin-x.com/api/agents/{agent_id}/usage/sessions`
- Auth: HTTP bearer

Per-session breakdown for one agent.

Rows where the gateway didn't have an active conversation_id at debit
time collapse into a single row with conversation_id=null and
title=null — surface as "Other" in the UI.

## Path parameters

- `agent_id` string, uuid, required

## Query parameters

- `days` integer
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- AgentSessionsResponse
  - `agent_id` string, uuid, required
  - `days` integer, required
  - `sessions` SessionUsageRow[], required
    - `conversation_id` string, nullable, required
    - `title` string, nullable, required
    - `credits_cents` integer, required
    - `calls` integer, required
    - `last_activity_at` string, date-time, nullable, required
  - `has_more` boolean, required
  - `next_offset` integer, nullable, required
  - `generated_at` string, date-time, required
  - `cache_hit` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tintin-x/apis/tintin-api.md) · [All operations](https://skmtc.dev/tintin-x/apis/tintin-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tintin-x/apis/tintin-api/revisions/8839a8d0a66c?raw)