---
title: "Retrieve organization usage reports"
method: GET
path: "/usage-report"
tags: ["organization"]
---

# Retrieve organization usage reports

`GET /usage-report`

## Request

- Base URL: `https://api-ch-gva-2.exoscale.com/v2`
- URL: `https://api-ch-gva-2.exoscale.com/v2/usage-report`
- Auth: none declared
- TypeScript: <https://skmtc.dev/exoscale/apis/exoscale-api/docs/usage-report/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns aggregated usage reports for an organization

## Query parameters

- `period` string

## Response `200`

200

- object
  - `usage` object[]
    - `from` string: Period Start Date
    - `to` string: Period End Date
    - `product` string: Product
    - `variable` string: Variable
    - `description` string: Description
    - `quantity` string: Quantity
    - `unit` string: Unit

---

[API](https://skmtc.dev/exoscale/apis/exoscale-api.md) - [All operations](https://skmtc.dev/exoscale/apis/exoscale-api/llms.txt) - [OpenAPI document](https://skmtc.dev/exoscale/apis/exoscale-api/revisions/63da6f74c845?raw)