> For the complete documentation index, see [llms.txt](https://doc.bodinat.de/doc/deepl/llms.txt)

# Get usage statistics as an admin

> GET /v2/admin/analytics
> 
> Retrieve usage statistics for the organization within a specified date range.
> Optionally group the results by API key or by API key and day.



## Servers
- DeepL API Pro: https://api.deepl.com (DeepL API Pro)
- DeepL API Free: https://api-free.deepl.com (DeepL API Free)


## Authentication methods
- Auth header


## Parameters


### Query parameters

- **start_date** (string(date))
  Start date for the usage report (ISO 8601 date format).

- **end_date** (string(date))
  End date for the usage report (ISO 8601 date format).

- **group_by** (string)
  Optional parameter to group usage statistics. Possible values:
   * `key` - Group by API key
   * `key_and_day` - Group by API key and usage date



## Responses
### 200
The usage statistics for the specified date range.
#### Headers

- **X-Trace-ID** ()


#### Body: application/json (object)
- **usage_report** (object)
  Contains the detailed usage statistics for the specified date range.


### 400
Bad request. Please check error message and your parameters.
#### Headers

- **X-Trace-ID** ()


#### Body: application/json (object)
- **message** (string)
  Error message describing the issue.


### 403
Authorization failed. Please supply a valid `DeepL-Auth-Key` via the `Authorization` header.
#### Headers

- **X-Trace-ID** ()


### 404
The requested resource could not be found.
#### Headers

- **X-Trace-ID** ()


### 500
Internal error.
#### Headers

- **X-Trace-ID** ()



[Powered by Bump.sh](https://bump.sh)
