# 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** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


#### 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** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


#### 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** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


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

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.


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

- **X-Trace-ID** ()
  A unique identifier for the request that can be included in bug reports to DeepL support.



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