---
title: "Query session costs with filters"
method: GET
path: "/api/session-costs"
tags: ["Session Data"]
---

# Query session costs with filters

`GET /api/session-costs`

## Query parameters

- `agentId` string
- `taskId` string
- `startDate` string
- `endDate` string
- `limit` integer

## Response `200`

Session costs

- object
  - `costs` SessionCost[], required
    - `id` string, uuid, required
    - `sessionId` string, required
    - `taskId` string, uuid
    - `agentId` string, required
    - `totalCostUsd` number, required
    - `inputTokens` integer
    - `outputTokens` integer
    - `cacheReadTokens` integer
    - `cacheWriteTokens` integer
    - `reasoningOutputTokens` integer
    - `thinkingTokens` integer
    - `durationMs` integer, required
    - `numTurns` integer, nullable, required
    - `model` string, required
    - `isError` boolean
    - `costSource` 'harness' | 'pricing-table' | 'unpriced'
    - `harnessCostUsd` number, nullable
    - `cacheWrite5mTokens` integer, nullable
    - `cacheWrite1hTokens` integer, nullable
    - `modelBreakdown` SessionCostModelBreakdown[], nullable
      - `model` string, required
      - `inputTokens` integer, required
      - `outputTokens` integer, required
      - `cacheReadTokens` integer, required
      - `cacheWriteTokens` integer, required
      - `webSearchRequests` integer, nullable
      - `costUsd` number, nullable
      - `harnessCostUsd` number, nullable
    - `createdAt` string, date-time, required

---

[API](https://skmtc.net/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.net/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/desplega-ai/agent-swarm-api/versions/0375890be8c4/schema)