---
title: "Get Cost"
method: GET
path: "/teams/cost/graph"
tags: ["TEAMS"]
---

# Get Cost

`GET /teams/cost/graph`

## Query parameters

- `teams` string[]
- `start_date` string
- `end_date` string
- `aggregate_by` 'day' | 'week' | 'month'
- `instance_id` string

## Headers

- `x-tenant` string, required

## Response `200`

Successful Response

- CostGraphResponse
  - `summary` AppSchemasTeamCostSummary, required
    - `total_spend` number, required
    - `active_teams` integer, required
    - `average_daily_spend` number, required
    - `unaccounted_spend` number, required
  - `spend_by_teams` DailyTeamSpend[], required
    - `date` string, required
    - `team_spends` object, required
  - `meta` object, required — Period start and end dates

## Other responses

- `400` — Invalid data
- `403` — Not supported for public user
- `422` — Validation Error

## Changes

- **2026-09-15** `8a08bdb37cfa` — 1 breaking, 3 info
  - the `query` request parameter `aggregate_by` was restricted to a list of enum values
  - added the new enum value `day` to the `query` request parameter `aggregate_by`
  - added the new enum value `month` to the `query` request parameter `aggregate_by`
  - added the new enum value `week` to the `query` request parameter `aggregate_by`

[Change history](https://skmtc.dev/myaltimate/apis/fastapi/changes/teams/cost/graph/get.md)

---

[API](https://skmtc.dev/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.dev/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/myaltimate/apis/fastapi/revisions/4dfe86ff412c?raw)