Skip to main content
GET
/
organizations
/
{organization_id}
/
usage
cURL
curl "https://api.ionq.co/v0.4/organizations/com.my.org/usage?group_by=project&start_date=2025-01-01&end_date=2025-03-02&modality=weekly" \
  -H "Authorization: apiKey your-api-key"
{
  "group_type": "project",
  "modality": "daily",
  "amount_total": 151.31,
  "job_count": 514,
  "organization": "71d164e-6ebe-4126-8839-f1529bb01a00",
  "time_us_total": 1566154.312523,
  "usage_data": [
    {
      "amount": 1614.23,
      "from": "2023-07-01",
      "group_usages": [
        {
          "amount": 144.39,
          "group_id": "2bfd0fd5-5854-4916-917f-a907af586755",
          "group_name": "Project Jumping Lemming",
          "job_count": 9,
          "time_us": 1566154.312523
        }
      ],
      "job_count": 10,
      "time_us": 5143166.13413
    }
  ],
  "usage_from": "2025-10-01T00:00:00Z",
  "usage_to": "2025-11-01T00:00:00Z",
  "usage_unit": "USD"
}

Path Parameters

​
organization_id
string<uuid>
required

The UUID of the organization — this UUID is provided in the response on organization creation.

Query Parameters

​
start_date
string<date>
required

Start date, inclusive

​
end_date
string<date>
required

End date, exclusive

​
group_by
enum<string>
required

QPU Usage grouping

Available options:
job,
project,
user
Example:

"project"

​
modality
enum<string>
required

Report modality

Available options:
daily,
weekly,
monthly
Example:

"daily"

Response

200 - application/json

Successfully retrieved a list of projects.

QPU usage details for a given modality and date range.

​
group_type
enum<string>
required

QPU Usage grouping

Available options:
job,
project,
user
Example:

"project"

​
modality
enum<string>
required

Report modality

Available options:
daily,
weekly,
monthly
Example:

"daily"

​
amount_total
number

The total cost amount for the given timeframe, in units given by usage_unit

Example:

151.31

​
job_count
integer

The total number of jobs run in the timeframe

Example:

514

​
organization
string<uuid>

UUID of an organization.

Example:

"71d164e-6ebe-4126-8839-f1529bb01a00"

​
time_us_total
number

The total QPU time usage for the given timeframe, in microseconds

Example:

1566154.312523

​
usage_data
object[]

The breakdown of usage by group type in date order most to least recent

​
usage_from
string<date-time>

Usage beginning RFC 3339 timestamp

Example:

"2025-10-01T00:00:00Z"

​
usage_to
string<date-time>

Usage end RFC 3339 timestamp

Example:

"2025-11-01T00:00:00Z"

​
usage_unit
string

The currency of the total and job cost amounts

Example:

"USD"