---
title: "Changes to Get Granular Usage"
method: GET
path: "/api/v1/orgs/current/billing/granular-usage"
---

# Changes to Get Granular Usage

`GET /api/v1/orgs/current/billing/granular-usage`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 77 revisions.

- **2026-10-16** `1a8ee9358d81`: 4 breaking, 10 info

## Changes

- **2026-10-16** `1a8ee9358d81`: 4 breaking, 10 info
  - the `detail/items/` response's property type changed from `object` to `string` for status `422`
  - removed the required property `detail/items/loc` from the response with the `422` status
  - removed the required property `detail/items/msg` from the response with the `422` status
  - removed the required property `detail/items/type` from the response with the `422` status
  - added the new optional `query` request parameter `kind`
  - added the new optional `query` request parameter `trace_tier`
  - the `query` request parameter `workspace_ids` became optional
  - added the new enum value `trace_tier` to the `query` request parameter `group_by`
  - `query` request parameter `workspace_ids` list-of-types was widened by adding types `null`
  - for the `query` request parameter `workspace_ids`, the type was generalized from `array` to no type
  - added the optional property `usage/items/agent_runs` to the response with the `200` status
  - added the optional property `usage/items/agent_uptime_seconds` to the response with the `200` status
  - added the optional property `usage/items/dimensions/trace_tier` to the response with the `200` status
  - added the optional property `usage/items/nodes_executed` to the response with the `200` status

---

[Operation](https://skmtc.dev/langchain-ai/apis/langsmith/docs/api/v1/orgs/current/billing/granular-usage/get.md) - [API](https://skmtc.dev/langchain-ai/apis/langsmith.md) - [Page](https://skmtc.dev/langchain-ai/apis/langsmith/changes/api/v1/orgs/current/billing/granular-usage/get)