---
title: "Get usage costs"
method: GET
path: "/organizations/{organization_id}/usage"
tags: ["usage"]
---

# Get usage costs

`GET /organizations/{organization_id}/usage`

Retrieves the costs of a given group type, broken down by the given date modality.

## Path parameters

- `organization_id` string, uuid, required

## Query parameters

- `start_date` string, date, required
- `end_date` string, date, required
- `group_by` 'job' | 'project' | 'user', required — QPU Usage grouping
- `modality` 'daily' | 'weekly' | 'monthly', required — Report modality

## Response `200`

Successfully retrieved a list of projects.

- Usages — QPU usage details for a given modality and date range.
  - `amount_total` number — The total cost amount for the given timeframe, in units given by usage_unit
  - `group_type` 'job' | 'project' | 'user', required — QPU Usage grouping
  - `job_count` integer — The total number of jobs run in the timeframe
  - `modality` 'daily' | 'weekly' | 'monthly', required — Report modality
  - `organization` string, uuid — UUID of an organization.
  - `time_us_total` number — The total QPU time usage for the given timeframe, in microseconds
  - `usage_data` Usage[] — The breakdown of usage by group type in date order most to least recent
    - `amount` number, required — The amount as a cost in USD
    - `from` string, date, required — Date for this group's usage
    - `group_usages` GroupUsage[], required — The top 5 usage groups in order of cost amount descending
      - `amount` number — The cost amount for the group of the given date
      - `group_id` string — The unique ID from the group
      - `group_name` string — The group's descriptive name
      - `job_count` integer — The number of jobs run for the group on the given date
      - `time_us` number — The QPU time in microseconds
    - `job_count` integer, required — The count of jobs for this group on the given from date
    - `time_us` number, required — The QPU time in microseconds
  - `usage_from` string, date-time — Usage beginning RFC 3339 timestamp
  - `usage_to` string, date-time — Usage end RFC 3339 timestamp
  - `usage_unit` string — The currency of the total and job cost amounts

---

[API](https://skmtc.net/ionq/apis/ionq-cloud-platform-api.md) · [All operations](https://skmtc.net/ionq/apis/ionq-cloud-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ionq/ionq-cloud-platform-api/versions/0410071e1cd0/schema)