---
title: "Record actual spend"
method: POST
path: "/api/burnrate/track"
tags: ["BurnRate"]
---

# Record actual spend

`POST /api/burnrate/track`

## Request

- Base URL: `https://plith.ai`
- URL: `https://plith.ai/api/burnrate/track`
- Auth: none required

Records actual LLM token spend for an org. Actual cost is computed server-side from the pricing table — callers do not supply a cost figure. FREE — no credit deduction.

## Request body

- object
  - `provider` string, required
  - `model` string, required
  - `input_tokens` integer, required
  - `output_tokens` integer, required
  - `task_id` string: Optional. Your task ID for cross-referencing with DedupQ.
  - `cache_read_tokens` integer: Optional. Cache read tokens for providers with prompt caching.

## Response `200`

Spend recorded

- object
  - `tracked` boolean
  - `record_id` string, uuid
  - `provider` string
  - `model` string
  - `input_tokens` integer
  - `output_tokens` integer
  - `actual_cost_usd` number
  - `actual_cost_usd_formatted` string
  - `pricing_found` boolean
  - `note` string
  - `cross_product` object
  - `request_id` string
  - `credits_used` integer
  - `credits_remaining` integer
  - `fallback_behavior` string

## Other responses

- `400`: Missing or invalid fields
- `401`: Invalid or missing API key
- `500`: Internal server error

---

[API](https://skmtc.dev/plith/apis/plith-api.md) · [All operations](https://skmtc.dev/plith/apis/plith-api/llms.txt) · [OpenAPI document](https://skmtc.dev/plith/apis/plith-api/revisions/4a03164b0d75?raw)