# **GET** /api/speak/v2/{ :id }

> An API for reading status about synthesis voice.

## 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/speak/{your-speak-id} \
  --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`.                        |

### `result` consists of followings

| key                      | description                                                      |
|--------------------------|------------------------------------------------------------------|
| __`audio_download_url`__ | an url for audio file that will be expired after 24 hours later. |
| __`status`__             | status of synthesizing voice.                                    |
|                          | `done` - downloadable audio file is ready.                       |
|                          | `progress` - you have to wait few seconds.                       |
|                          | `failed` - your request is failed.                               |
|                          | `started` - Synthesizing is ready to proceed.                    |
| __`text_count`__         | length of the `text` that you requested.                         |
| __`duration`__           | how much time it took. (sec)                                     |

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

  ```json
{
    "result": {
        "_id": "64a25c4fe671d3676a7a6332",
        "audio_download_url": "https://cdn.typecast.ai/blah_the_audio_file_url_blah",
        "text_count": 7,
        "duration": 1.436734693877551,
        "status": "done"
    }
}
  ```

</details>