# **GET** /api/actor/{ :id }/versions

> Retrieve character's model versions and predefined emotions

```{caution}
Except for **latest** alias model, the model may be unstable or slow.
```

## Request

### Headers

* [Required headers](reference/request.md#headers)

### Parameters

* None

<details open>
  <summary>Example with cURL</summary>

  ```bash
      curl --request GET \
          --url https://typecast.ai/api/actor/${24-letters-your_actor_id}/versions \
          --header "Content-Type: application/json" \
          --header "Authorization: Bearer $API_TOKEN"
  ```

</details>

## Response

### Status Code

| status code | value                                                   |
|-------------|---------------------------------------------------------|
| 401         | [Authorization Error](reference/error.md#error-codes)   |
| 200         | JSON Object that has `result`, version list(JSON Array) |

### Element of `result` consists of followings

| key                | description                                        |
|--------------------|----------------------------------------------------|
| __`name`__         | name of a model version.                           |
| __`aliases`__      | alias name of the model version.                   |
| __`display_name`__ | used as the model_version in the POST /api/speak endpoint.    |
| __`emotion_tone_presets`__ | all emotions of the actor for the model version.   |
|                    | `first` is the first-time model of the actor.      |
|                    | `latest` is the last-time model of the actor.      |
| __`emotion_prompt`__     | a flag that `emotion_prompt` module is activated or not. |

<details open>
  <summary>Example</summary>

  ```json
{
    "result": [
        {
            "name": "v1",
            "aliases": [
                "first"
            ],
            "display_name": "CATS",
            "emotion_tone_presets": [
                "happy-1",
                "happy-2",
                "happy-3",
                "0",
                "normal-1"
            ],
            "emotion_prompt": false
        },
        {
            "name": "v2",
            "aliases": [],
            "display_name": "CATS",
            "emotion_tone_presets": [
                "happy-1",
                "happy-2",
                "happy-3",
                "0",
                "normal-1"
            ],
            "emotion_prompt": false
        },
        {
            "name": "v3",
            "aliases": [
              "latest"
            ],
            "display_name": "SSFM-V2.0",
            "emotion_tone_presets": [
                "happy-1",
                "happy-2",
                "happy-3",
                "0",
                "normal-1"
            ],
            "emotion_prompt": true
        }
    ]
}
  ```

</details>