---
title: "Post Serving Usage"
method: POST
path: "/api/billing/serving-usage"
tags: ["billing"]
---

# Post Serving Usage

`POST /api/billing/serving-usage`

Meter + bill a serving request's tokens (per-token at Fireworks cost + 20%).

Machine-to-machine: the serving layer calls this after generating, authenticated with
the internal key. Debits the org's prepaid balance and records the usage row. The serving
caller reports fire-and-forget (at-most-once), so a dropped report under-meters rather than
double-bills; the stable per-generation ``requestId`` keeps it idempotent if a retry is ever
added (a replay with the same id returns the original charge without debiting again).

The caller may send ``orgId`` directly, or just ``adapterId`` (the serving layer's case) —
we resolve the owning org from the adapter when ``orgId`` is absent.

Cross-tenant safety (mirrors the ``/api/sample`` BOLA hardening): the adapter has exactly one
owning org, so whenever ``adapterId`` is present it is the AUTHORITATIVE source of the billing
org. A client-supplied ``orgId`` may never override it — if both are given they must match, or
we reject (a mismatch means the caller is trying to bill another tenant for this adapter's
usage, or vice-versa). ``orgId`` alone is honored only when no ``adapterId`` is supplied.

## Request body

- ServingUsageBody
  - `orgId` string, nullable
  - `baseModel` string, required
  - `promptTokens` integer, required
  - `completionTokens` integer, required
  - `cachedTokens` integer
  - `adapterId` string, nullable
  - `gpuSeconds` number, nullable
  - `requestId` string, nullable
  - `engineReplicaId` string, nullable
  - `servingDeploymentId` string, nullable
  - `cachedTokensReported` boolean, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/freesolo/apis/platform-backend.md) · [All operations](https://skmtc.dev/freesolo/apis/platform-backend/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/freesolo/platform-backend/revisions/5626e92675af/schema)