API Reference

Attribution Data API

Dimensional cost analysis grouped by model, provider, feature, agent, or workflow.

  • GET List unique agent IDs: Returns distinct agent_id values from usage event metadata for the given date range, sorted alphabetically.
  • GET Get cost breakdown by agent: Returns cost aggregation grouped by agent_id from usage event metadata.
  • GET Get cost breakdown by dimension: Returns cost aggregation grouped by any metadata dimension key.
  • GET Get cost per declared outcome: Returns the true cost per unit of value: for every outcome your spans declare (see the tracing guide), completed, failed, and unresolved units side by side.
  • GET Get cost breakdown by workflow: Returns cost aggregation grouped by workflow_id from usage event metadata.
  • GET List distinct dimension keys: Returns distinct metadata dimension keys from usage events within a date range, sorted alphabetically.
  • GET List unique dimension values: Returns distinct values of a metadata dimension key in the date range, sorted alphabetically.
  • GET Compare session types: Returns a per-session-type cost comparison with a cost efficiency ratio.
  • GET Get session cost breakdown: Returns per-session cost totals, ordered by total cost descending.
  • GET Get session detail: Returns a per-feature cost breakdown for one session.
  • GET Get session call tree: Reconstructs one session's span call tree: one node per span with its own cost, its subtree cost (the span plus every descendant), and its nested children, so you can see which branch of a multi-agent run spent the money.
  • GET Get attribution time-series: Returns time-bucketed multi-series cost data grouped by any metadata dimension key.
  • GET List unique workflow IDs: Returns distinct workflow_id values from usage event metadata for the given date range, sorted alphabetically.

← All API groups