---
title: "Get conversation consumption"
method: GET
path: "/api/v1/w/{wId}/assistant/conversations/{cId}/consumption"
tags: ["Conversations"]
---

# Get conversation consumption

`GET /api/v1/w/{wId}/assistant/conversations/{cId}/consumption`

## Request

- Base URL: `https://dust.tt`
- URL: `https://dust.tt/api/v1/w/{wId}/assistant/conversations/{cId}/consumption`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/dust-tt/apis/dust-api-documentation/docs/api/v1/w/:wId/assistant/conversations/:cId/consumption/get.ts> (a function with typed inputs; its response is checked against the schema)

Get the same credit breakdown as the conversation consumption view for a conversation
the caller can read. Returns stable billed credits for terminal agent messages, including
superseded message versions and accessible recursively spawned run-agent conversations.
In-progress messages are excluded until they reach a terminal state.

Details use each billed message's newest complete stored attribution. They are null when
no messages have positive billed credits or any billed message lacks complete attribution.
Agent work and tool attributions partition the bill. Models and agents are alternative
groupings of that bill, not additional charges. This endpoint does not return token counts
or a cached-versus-uncached input breakdown.

## Path parameters

- `wId` string, required
- `cId` string, required

## Response `200`

Conversation consumption retrieved successfully.

- ConversationConsumption
  - `billedCredits` number, required: Stable billed Dust credits for terminal agent messages in the conversation and its accessible run-agent descendants, including superseded message versions.
  - `details` ConversationConsumptionDetails, required: Attribution reconciled to the bill through model input rows. Agent work plus tool attributed credits partition the bill; models and agents are alternative groupings, not additional charges.
    - `agentWorkCredits` number, required: Credits attributed to agent work rather than visible tools.
    - `tools` ConversationConsumptionToolDetails[], required
      - `label` string, required: Display label of the tool.
      - `internalMCPServerName` string, nullable, required: Internal MCP server name, or null for an external server.
      - `toolName` string, required
      - `callCount` integer, required: Number of attributed calls grouped under this tool.
      - `attributedCredits` number, required: Share of billed credits attributed to the tool, including model work and direct charges.
      - `directCredits` number, required: Direct tool charges already included in attributedCredits, not an additional charge.
      - `pending` boolean, required: Whether any grouped tool attribution is pending.
    - `models` ConversationConsumptionModelDetails[], required
      - `providerId` string, required
      - `modelId` string, required: Provider model identifier, not an internal database identifier.
      - `displayName` string, required
      - `attributedCredits` number, required: Reconciled credits grouped by model, including tool attribution linked to its runs. Overlaps agent work and tool totals.
    - `agents` ConversationConsumptionAgentDetails[], required
      - `agentId` string, required: String identifier of the agent.
      - `name` string, required
      - `pictureUrl` string, nullable, required
      - `billedCredits` number, required: Stable billed credits grouped under this agent. Hidden helpers are folded into their parent agent.
      - `agentWorkCredits` number, required
      - `tools` ConversationConsumptionToolDetails[], required
        - `label` string, required: Display label of the tool.
        - `internalMCPServerName` string, nullable, required: Internal MCP server name, or null for an external server.
        - `toolName` string, required
        - `callCount` integer, required: Number of attributed calls grouped under this tool.
        - `attributedCredits` number, required: Share of billed credits attributed to the tool, including model work and direct charges.
        - `directCredits` number, required: Direct tool charges already included in attributedCredits, not an additional charge.
        - `pending` boolean, required: Whether any grouped tool attribution is pending.
      - `models` ConversationConsumptionModelDetails[], required
        - `providerId` string, required
        - `modelId` string, required: Provider model identifier, not an internal database identifier.
        - `displayName` string, required
        - `attributedCredits` number, required: Reconciled credits grouped by model, including tool attribution linked to its runs. Overlaps agent work and tool totals.

## Other responses

- `400`: Invalid request parameters.
- `401`: Invalid or missing authentication credentials.
- `403`: The workspace plan does not allow API access.
- `404`: Workspace or conversation not found, deleted, or not accessible to the caller.
- `500`: Internal server error.

## Changes

- **2026-10-09** `afdf874a9110`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/dust-tt/apis/dust-api-documentation/changes/api/v1/w/:wId/assistant/conversations/:cId/consumption/get.md)

---

[API](https://skmtc.dev/dust-tt/apis/dust-api-documentation.md) - [All operations](https://skmtc.dev/dust-tt/apis/dust-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/dust-tt/apis/dust-api-documentation/revisions/abb1c0993938?raw)