---
title: "GET /models"
method: GET
path: "/models"
tags: ["Models"]
---

# GET /models

`GET /models`

Retrieves model metadata and, optionally, model definitions.
Status codes:
* 200 OK
* 400 Bad Request
  * InvalidArgument - The model id is invalid.
  * LimitExceeded - The maximum number of model ids allowed in 'dependenciesFor' has been reached.
* 404 Not Found
  * ModelNotFound - The model was not found.

## Query parameters

- `dependenciesFor` string[]
- `includeModelDefinition` boolean
- `api-version` string, required

## Headers

- `max-items-per-page` integer

## Response `200`

Success

- PagedDigitalTwinsModelDataCollection — A collection of DigitalTwinsModelData objects.
  - `value` DigitalTwinsModelData[], required — The DigitalTwinsModelData objects.
    - `displayName` object — A language map that contains the localized display names as specified in the model definition.
    - `description` object — A language map that contains the localized descriptions as specified in the model definition.
    - `id` string, required — The id of the model as specified in the model definition.
    - `uploadTime` string, date-time — The time the model was uploaded to the service.
    - `decommissioned` boolean — Indicates if the model is decommissioned. Decommissioned models cannot be referenced by newly created digital twins.
    - `model` object — The model definition.
  - `nextLink` string — A URI to retrieve the next page of objects.

## Other responses

- `default` — Default response.

---

[API](https://skmtc.net/azure/apis/digitaltwins-digitaltwins.md) · [All operations](https://skmtc.net/azure/apis/digitaltwins-digitaltwins/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/digitaltwins-digitaltwins/versions/8d81dcdaf9a2/schema)