---
title: "GET /usage"
method: GET
path: "/usage"
---

# GET /usage

`GET /usage`

Retrieves (queries) aggregated usage data for an account.

## Query parameters

- `timeRange` string

## Response `200`

Success

- GetUsageTotalsResponse
  - `timeRange` 'MONTH_TO_DATE' | 'PAST_30_DAYS' — The inclusive time period that the usage data applies to. Possible values are: MONTH_TO_DATE, for the current calendar month to date; and, PAST_30_DAYS, for the preceding 30 days.
  - `usageTotals` UsageTotal[] — An array of objects that contains the results of the query. Each object contains the data for a specific usage metric.
    - `currency` 'USD' — The type of currency that the value for the metric (estimatedCost) is reported in.
    - `estimatedCost` string — The estimated value for the metric.
    - `type` 'DATA_INVENTORY_EVALUATION' | 'SENSITIVE_DATA_DISCOVERY' | 'AUTOMATED_SENSITIVE_DATA_DISCOVERY' | 'AUTOMATED_OBJECT_MONITORING' — The name of the metric. Possible values are: AUTOMATED_OBJECT_MONITORING, to monitor S3 objects for automated sensitive data discovery; AUTOMATED_SENSITIVE_DATA_DISCOVERY, to analyze S3 objects for automated sensitive data discovery; DATA_INVENTORY_EVALUATION, to monitor S3 buckets; and, SENSITIVE_DATA_DISCOVERY, to run classification jobs.

## Other responses

- `480` — ValidationException
- `481` — InternalServerException
- `482` — ServiceQuotaExceededException
- `483` — AccessDeniedException
- `484` — ResourceNotFoundException
- `485` — ThrottlingException
- `486` — ConflictException

---

[API](https://skmtc.net/aws/apis/macie2.md) · [All operations](https://skmtc.net/aws/apis/macie2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/macie2/versions/6252cf55d8ef/schema)