Skip to main content
GET
/
api
/
v1
/
orgs
/
current
/
billing
/
granular-usage
/
export
Error
A valid request URL is required to generate request examples
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
start_time
string<date-time>
required
​
end_time
string<date-time>
required
​
workspace_ids
string<uuid>[]
required
​
group_by
enum<string>
default:workspace

Dimensions for grouping granular usage data.

Available options:
user,
api_key,
project,
workspace,
trace_tier
​
kind
enum<string>
default:traces

Which billable usage domain a granular-usage query targets.

  • traces: trace counts.
  • langsmith_deployments: LangSmith Deployment metrics (nodes executed, agent runs, agent uptime).

Default is traces for backward compatibility — existing callers of GET /granular-usage without a kind query param get the same response shape they always did.

Available options:
traces,
langsmith_deployments
​
trace_tier
enum<string> | null
Available options:
longlived,
shortlived

Response

Successful Response