# Get trained models usage info


**GET /_ml/trained_models/{model_id}/_stats**

**All methods and paths for this operation:**

<div>
                      <span class="operation-verb get">GET</span>
                      <span class="operation-path">/_ml/trained_models/_stats</span>
                      </div>
                    <div>
                      <span class="operation-verb get">GET</span>
                      <span class="operation-path">/_ml/trained_models/{model_id}/_stats</span>
                      </div>
                    

You can get usage information for multiple trained
models in a single API request by using a comma-separated list of model IDs or a wildcard expression.

## Required authorization

* Cluster privileges: `monitor_ml`



## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Api key auth
- Basic auth
- Bearer auth


## Parameters

### Path parameters
- **model_id** (string | array[string])
  The unique identifier of the trained model or a model alias. It can be a
  comma-separated list or a wildcard expression.

### Query parameters
- **allow_no_match** (boolean)
  Specifies what to do when the request:

  - Contains wildcard expressions and there are no models that match.
  - Contains the _all string or no identifiers and there are no matches.
  - Contains wildcard expressions and there are only partial matches.

  If true, it returns an empty array when there are no matches and the
  subset of results when there are partial matches.
- **from** (number)
  Skips the specified number of models.
- **size** (number)
  Specifies the maximum number of models to obtain.


## Responses
### 200


#### Body: application/json (object)
- **count** (number)
  The total number of trained model statistics that matched the requested ID patterns. Could be higher than the number of items in the trained_model_stats array as the size of the array is restricted by the supplied size parameter.
- **trained_model_stats** (array[object])
  An array of trained model statistics, which are sorted by the model_id value in ascending order.


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