---
title: "Get organization usage summary for dashboard"
method: GET
path: "/v1/organization/usage/{organization_id}"
tags: ["Organization"]
---

# Get organization usage summary for dashboard

`GET /v1/organization/usage/{organization_id}`

Get organization usage summary including current and previous billing periods.

## Path parameters

- `organization_id` integer, required

## Response `200`

Successful Response

- OrganizationUsageResponse — Organization usage data formatted for frontend dashboard.
  - `current_billing_period` BillingPeriod, required — Billing period usage summary.
    - `month_starting` string, required — Month starting date (YYYY-MM-DD)
    - `tokens_used` integer, required — Total tokens used in the period
    - `search_queries_used` integer, required — Total search queries used in the period
    - `spend_cents` integer, required — Total spend in cents for the period
  - `previous_billing_periods` BillingPeriod[] — Previous months usage history
    - `month_starting` string, required — Month starting date (YYYY-MM-DD)
    - `tokens_used` integer, required — Total tokens used in the period
    - `search_queries_used` integer, required — Total search queries used in the period
    - `spend_cents` integer, required — Total spend in cents for the period

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/flower/apis/superlink-api.md) · [All operations](https://skmtc.dev/flower/apis/superlink-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/flower/superlink-api/revisions/adf853ac4f41/schema)