Skip to main content
GET
Read a conversation's model cost and µ totals

Authorizations

Authorization
string
header
required

Supabase JWT token in Authorization: Bearer header

Path Parameters

org_id
string
required

Organization identifier (e.g. org-abc12345)

Query Parameters

lineage_key
string[]

The conversation's lineage key; repeat it for up to 100 lineages (more is 400). Required unless from/to are given; with a window it names the pilot lineages for the bound split.

Required array length: 1 - 100 elements
Required string length: 1 - 256
binding
enum<string>[]

Optional pass-through label per lineage, repeated once per lineage_key in the same order, echoed back as binding. Never derived or stored by this route.

Available options:
pilot_pr,
starter,
unbound
from
string<date-time>

Window start, inclusive, ISO-8601 with a zone. Give with to; at most 30 days, not before the retention floor.

to
string<date-time>

Window end, exclusive, ISO-8601 with a zone; not in the future.

Response

The lineage's totals.

lineage_key
string
required
model_cost_mmu
string
required

Sum of the lineage's model cost, integer millimu as a decimal string.

Pattern: ^(0|[1-9][0-9]{0,18})$
mu_charged_mmu
string | null
required

Sum of the µ billing charged, integer millimu as a decimal string. null when billing has no row for the lineage ("not charged").

Pattern: ^(0|[1-9][0-9]{0,18})$
as_of
string<date-time>
required

Server time of this read, ISO-8601.

row_count
integer
required

Number of record rows summed into the totals (gateway and billing).

Required range: x >= 1
binding
enum<string>

The caller-supplied label, echoed back; present only when supplied.

Available options:
pilot_pr,
starter,
unbound