# **GET** /api/actor

> Retrieve all activated characters. You have to use `result.[].actor_id`  to call `/api/speak` .

## 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 \
          --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`, actor list(JSON Array) |

### Element of `result` consists of followings

| key            | description                                                                  |                            |
|----------------|------------------------------------------------------------------------------|----------------------------|
| __`actor_id`__ | string that represents actor's unique id that is used when creating _speak_. |
| __`name`__     | object that represents actor's name and key is language code.                |
|                | __`en`__                                                                     | english name of the actor. |
|                | __`ko`__                                                                     | korean name of the actor.  |

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

  ```json
{
    "result": [
        {
          "actor_id": "5c3c52c9ea9791000747155b",
          "name": {
            "en": "Byumsoo",
            "ko": "범수"
          }
        },
        {
          "actor_id": "5c3c52c9ea9791000747155c",
          "name": {
            "en": "Camila",
            "카밀라": "카밀라"
          }
        }
    ]
}
  ```

</details>