---
title: "POST /usage/list"
method: POST
path: "/usage/list"
---

# POST /usage/list

`POST /usage/list`

Lists the Amazon Inspector usage totals over the last 30 days.

## Request body

- object
  - `maxResults` integer — The maximum number of results the response can return. If your request would return more than the maximum the response will return a <code>nextToken</code> value, use this value when you call the action again to get the remaining results.
  - `nextToken` string — A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request to a list action. If your response returns more than the <code>maxResults</code> maximum value it will also return a <code>nextToken</code> value. For subsequent calls, use the <code>nextToken</code> value returned from the previous request to continue listing results after the first page.
  - `accountIds` UsageAccountId[] — The Amazon Web Services account IDs to retrieve usage totals for.

## Response `200`

Success

- ListUsageTotalsResponse
  - `nextToken` string — The pagination parameter to be used on the next list operation to retrieve more items.
  - `totals` UsageTotal[] — An object with details on the total usage for the requested account.
    - `accountId` string — The account ID of the account that usage data was retrieved for.
    - `usage` Usage[] — An object representing the total usage for an account.
      - `type` 'EC2_INSTANCE_HOURS' | 'ECR_INITIAL_SCAN' | 'ECR_RESCAN' | 'LAMBDA_FUNCTION_HOURS' | 'LAMBDA_FUNCTION_CODE_HOURS' | 'CODE_REPOSITORY_SAST' | 'CODE_REPOSITORY_IAC' | 'CODE_REPOSITORY_SCA' | 'EC2_AGENTLESS_INSTANCE_HOURS' | 'AZURE_CONTAINER_IMAGE_INITIAL_SCAN' | 'AZURE_CONTAINER_IMAGE_RESCAN' | 'AZURE_VM_AGENT_BASED_INSTANCE_HOURS' | 'AZURE_SERVERLESS_FUNCTION_HOURS' — The type scan.
      - `total` number, double — The total of usage.
      - `estimatedMonthlyCost` number, double — The estimated monthly cost of Amazon Inspector.
      - `currency` 'USD' — The currency type used when calculating usage data.
      - `cloudProvider` 'AWS' | 'AZURE' | 'NOT_APPLICABLE' — The cloud provider associated with the usage information.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — ThrottlingException
- `483` — InternalServerException

---

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