---
title: "Get usage records by date range"
method: GET
path: "/usage"
---

# Get usage records by date range

`GET /usage`

## Path parameters

- `startDate` number, required
- `endDate` number, required

## Response `200`

OK

- Usage — usage cost of the aws account from start date to end date
  - `principalId` string — principalId of the user who owns the lease of the AWS account
  - `accountId` string — accountId of the AWS account
  - `startDate` number — usage start date as Epoch Timestamp
  - `endDate` number — usage end date as Epoch Timestamp
  - `costAmount` number — usage cost Amount of AWS account for given period
  - `costCurrency` string — usage cost currency
  - `timeToLive` number — ttl attribute as Epoch Timestamp

## Other responses

- `403` — Failed to authenticate request

## Changes

- **2019-10-21** `eed5055f8eb6` — 3 warning
  - the optional response header `Access-Control-Allow-Headers` removed for the status `200`
  - the optional response header `Access-Control-Allow-Methods` removed for the status `200`
  - the optional response header `Access-Control-Allow-Origin` removed for the status `200`

[Change history](https://skmtc.dev/optum/apis/namespace/changes/usage/get.md)

---

[API](https://skmtc.dev/optum/apis/namespace.md) · [All operations](https://skmtc.dev/optum/apis/namespace/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/optum/namespace/revisions/11d73002ea62/schema)