---
title: "Order Extended Audio Description"
method: POST
path: "/media_extended_audio_descriptions/order"
tags: ["Extended Audio Descriptions"]
---

# Order Extended Audio Description

`POST /media_extended_audio_descriptions/order`

Orders an extended audio description for a media. The request will charge the credit card on the account when the order is ready.
Only accounts on paid plans with the `order_audio_descriptions` feature can use this endpoint.

## Headers

- `X-Wistia-API-Version` string, required

## Request body

- object
  - `media_id` string, required — The hashed id of the media to order the extended audio description for.
  - `enabled` boolean — Whether the extended audio description should be automatically enabled once the order is complete.
  - `ai_enabled` boolean — Whether to use AI-generated audio descriptions (cheaper) or human-generated (higher quality).
  - `order_instructions` string — Optional instructions for the audio description provider.

## Response `200`

Extended audio description ordered successfully.

- object
  - `message` string, required — Success message indicating the order has been placed.
  - `order` object, required
    - `id` string, required — The hashed ID of the order. Use this to poll order status via the order_status endpoint.
    - `order_status` 'in_progress' | 'completed' | 'cancelled' | 'failed', required — The current status of the order.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `media` object, required
      - `id` string, required — A unique alphanumeric identifier for the record.
      - `index_url` string, required — A URL for fetching all the records of the given record type. You can pass hashed_ids as a param with multiple values to do a batch fetch for this records type.
      - `url` string, required — A URL that can be used to fetch this record.
    - `media_extended_audio_description` object, nullable — Link to the resulting media extended audio description. Null while the order is in progress.
      - `id` string, required — A unique alphanumeric identifier for the record.
      - `index_url` string, required — A URL for fetching all the records of the given record type. You can pass hashed_ids as a param with multiple values to do a batch fetch for this records type.
      - `url` string, required — A URL that can be used to fetch this record.

## Other responses

- `400` — Bad request
- `401` — Unauthorized, invalid or missing token
- `403` — Forbidden, token is valid but account does not have access to feature
- `404` — Resource not found
- `500` — Internal server error

---

[API](https://skmtc.dev/wistia/apis/data-api.md) · [All operations](https://skmtc.dev/wistia/apis/data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wistia/data-api/revisions/e40b3678d9d5/schema)