> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperbeam.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Usage

## Parameters

**tenant\_id** `string`

Optional query parameter. Returns all usage associated with provided `tenant_id`

## Response

**usage** `object`

**date** `string`

The first date of a month grouping. Formatted according to RFC3339
(e.g. 2006-01-02T15:04:05Z07:00)

**seconds** `number`

The number of seconds of total usage for the given month.

```bash cURL theme={null}
curl -H 'Authorization: Bearer <your-api-key>' \
    https://engine.hyperbeam.com/v0/vm/usage
```

```json Response Example theme={null}
{
  "usage": [
    {
      "date": "2024-02-01T00:00:00Z",
      "seconds": 2323
    },
    {
      "date": "2024-01-01T00:00:00Z",
      "seconds": 23232452
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.