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

# usage

## Constructor

```typescript
usage(http: HttpClient, config: ModusConfig): ManagementUsageResource
```

### Parameters

<ResponseField name={"http"} type={"HttpClient"} required />

<ResponseField name={"config"} type={"ModusConfig"} required />

### Returns

`ManagementUsageResource`

## Methods

### list()

```typescript
list(options: { since: string; until: string; rollup: UsageRollup; model: string; userEmail: readonly string[] }): Promise<object>
```

List usage metrics for your organization over a time window.

#### Parameters

<ResponseField name={"options"} type={"{ since: string; until: string; rollup: UsageRollup; model: string; userEmail: …"} required />

#### Returns

`Promise<object>`

Usage report rows for the window.

### listUsers()

```typescript
listUsers(options: { since: string; until: string }): Promise<object>
```

List distinct acting-user emails observed in a time window.

#### Parameters

<ResponseField name={"options"} type={"{ since: string; until: string }"} required />

#### Returns

`Promise<object>`

User emails seen in usage during the window.