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

# List categories models

`GET /v1/models/categories`

(Beta) Returns all custom categories models associated with this service instance.

## Response `200`

Models retrieved

- CategoriesModelList — List of categories models.
  - `models` CategoriesModel[] — The categories models
    - `name` string — An optional name for the model
    - `user_metadata` object — An optional map of metadata key-value pairs to store with this model
    - `language` string, required — The 2-letter language code of this model
    - `description` string — An optional description of the model
    - `model_version` string — An optional version string
    - `version` string — Deprecated — use `model_version`
    - `workspace_id` string, nullable — ID of the Watson Knowledge Studio workspace that deployed this model to Natural Language Understanding
    - `version_description` string, nullable — The description of the version
    - `features` string[] — The service features that are supported by the custom model
    - `status` 'starting' | 'training' | 'deploying' | 'available' | 'error' | 'deleted', required — When the status is `available`, the model is ready to use
    - `model_id` string, required — Unique model ID
    - `created` string, date-time, required — dateTime indicating when the model was created
    - `notices` Notice[]
      - `message` string — Describes deficiencies or inconsistencies in training data
    - `last_trained` string, date-time — dateTime of last successful model training
    - `last_deployed` string, date-time — dateTime of last successful model deployment

## Other responses

- `400` — Invalid request
- `403` — Access forbidden

---

[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)