---
title: "List models"
method: GET
path: "/v1/models"
tags: ["Manage models"]
---

# List models

`GET /v1/models`

Lists Watson Knowledge Studio [custom entities and relations models](https://cloud.ibm.com/docs/natural-language-understanding?topic=natural-language-understanding-customizing) that are deployed to your Natural Language Understanding service.

## Query parameters

- `version` string, required

## Response `200`

List models results

- ListModelsResults — Custom models that are available for entities and relations
  - `models` Model[] — An array of available models
    - `status` 'starting' | 'training' | 'deploying' | 'available' | 'error' | 'deleted' — When the status is `available`, the model is ready to use
    - `model_id` string — Unique model ID
    - `language` string — ISO 639-1 code that indicates the language of the model
    - `description` string — Model description
    - `workspace_id` string — ID of the Watson Knowledge Studio workspace that deployed this model to Natural Language Understanding
    - `model_version` string — The model version, if it was manually provided in Watson Knowledge Studio
    - `version` string — Deprecated — use `model_version`
    - `version_description` string — The description of the version, if it was manually provided in Watson Knowledge Studio
    - `created` string, date-time — A dateTime indicating when the model was created

## Other responses

- `400` — Invalid request

---

[API](https://skmtc.dev/ibm/apis/natural-language-understanding.md) · [All operations](https://skmtc.dev/ibm/apis/natural-language-understanding/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ibm/natural-language-understanding/revisions/9a693ab0d5ca/schema)