# Spend Breakdown

> The top groups by spend, each with its change against the previous period.

Canonical URL: https://docs.botyard.io/docs/api/spend/spend_breakdown_v1_orgs__org_id__spend_breakdown_post

`POST /v1/orgs/{org_id}/spend/breakdown`

The top groups by spend, each with its change against the previous period.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `org_id` | path | yes | string |  |

## Request body

`application/json`: SpendBreakdownRequest (required)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `from` | string (date-time) | yes | Inclusive range start |
| `to` | string (date-time) | yes | Exclusive range end |
| `where` | FilterNode_SpendFilterField_ \| null | no | Filter DSL tree, ANDed on top of the org and the range. See FilterNode for the condition / and / or shape. |
| `group_by` | SpendDimension | yes |  |
| `limit` | integer | no | Most groups to return |
| `cursor` | string \| null | no | The previous page's `next_cursor`, with the same `group_by`; omit for the first page. Pages follow spend (highest first), then calls, then the group key. |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| `200` | Successful Response | SpendBreakdownResponse |
| `default` | RFC 9457 Problem Details error response | ProblemDetails |

Full schemas: operation `spend_breakdown_v1_orgs__org_id__spend_breakdown_post` in the OpenAPI spec at https://api.botyard.io/openapi.json.