--- title: "Get Order" method: GET path: "/v1/productions/orders/{order_id}" tags: ["productions"] --- # Get Order `GET /v1/productions/orders/{order_id}` ## Request - Base URL: `https://api.elevenlabs.io` (the document declares no server; this is the origin it was published from) - URL: `https://api.elevenlabs.io/v1/productions/orders/{order_id}` - Auth: none declared Retrieves full details for a Productions order. Quote and pricing information may not be available immediately; if you wish to see the quote before submission, you may need to poll the order details until it is ready. ## Path parameters - `order_id` string, required ## Headers - `xi-api-key` string, nullable: Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website. ## Response `200` Successful Response - OrderResponse - `order_id` string, required - `name` string, required: The display name of the order. - `state` 'open' | 'submitted' | 'paid' | 'accepted' | 'rejected' | 'done' | 'cancelling' | 'cancelled' | 'expired' | 'merged', required - `items` OrderItemInfo[], required: The list of items in this order with their quotes. - `item_id` string, required - `item` union, required - DubOrderItemRequest - `kind` 'dub': The type of order item. - `media_id` string, required - `source_language` string, required: The language code of the source media (e.g. 'en', 'es'). - `destination_languages` string[], required: List of target language codes to dub the media into. - `include_captions` boolean, required: Whether to generate captions for the dubbed outputs. - `include_source_captions` boolean, required: Whether to generate captions for the source language. - `instructions` string, nullable: Optional free-text instructions for the dubbing team. - `captions_sdh` boolean, nullable: Whether captions should use SDH format, which includes descriptions for deaf and hard-of-hearing viewers. - SubtitleOrderItemRequest - `kind` 'subtitles': The type of order item. - `media_ids` MediaId[], required: The IDs of the uploaded media files to generate subtitles for. - `source_language` string, required: The language code of the source media (e.g. 'en', 'es'). - `destination_languages` string[], required: List of target language codes. Subtitles will be generated for each media file in each destination language. - `cue_options` CueOptionsRequest - `min_duration_ms` integer: Minimum duration of each cue in milliseconds. - `max_duration_ms` integer: Maximum duration of each cue in milliseconds. - `max_lines_per_cue` integer: Maximum number of lines per cue. - `max_chars_per_line` integer: Maximum number of characters per line in a cue. - `max_chars_per_s` integer, nullable: Maximum characters per second reading speed. If not set, no reading speed limit is applied. - `min_gap_between_cues_frames` integer, nullable: Minimum gap between consecutive cues in frames. If not set, no minimum gap is enforced. - `sdh` boolean: Whether subtitles should use SDH format, which includes descriptions for deaf and hard-of-hearing viewers. - `instructions` string, nullable: Optional free-text instructions for the subtitling team. - TranscriptionOrderItemRequest - `kind` 'transcription': The type of order item. - `media_ids` MediaId[], required: The IDs of the uploaded media files to transcribe. - `source_language` string, required: The language code of the source media (e.g. 'en', 'es'). - `verbatim` boolean: Whether to transcribe every word exactly, including filler words. - `instructions` string, nullable: Optional free-text instructions for the transcription team. - `quote` QuoteInfo - `amount_usd` number, required: The quoted price for this item in USD. Use the order's total_amount_usd for the combined order total. - `total_amount_usd` number, nullable: The total price for all items in USD. Excluded from response until quotes are available. - `sandbox` boolean: Whether this is a sandbox order that auto-progresses without producer intervention. - `created_at` string, date-time, required: The timestamp when the order was created. - `submitted_at` string, date-time, nullable: The timestamp when the order was submitted, if applicable. - `paid_at` string, date-time, nullable: The timestamp when payment was received, if applicable. - `accepted_at` string, date-time, nullable: The timestamp when the order was accepted for production, if applicable. - `completed_at` string, date-time, nullable: The timestamp when the order was completed, if applicable. - `cancel_reason` string, nullable: The reason the order was cancelled, if applicable. ## Other responses - `422`: Validation Error ## Changes - **2026-08-29** `331c41dbba6d`: 1 warning - added the new `merged` enum value to the `state` response property for the response status `200` - **2026-07-31** `72c54eba117e`: 3 warning, 1 info - added the new `cancelled` enum value to the `state` response property for the response status `200` - added the new `cancelling` enum value to the `state` response property for the response status `200` - added the new `expired` enum value to the `state` response property for the response status `200` - added the optional property `cancel_reason` to the response with the `200` status - **2026-07-13** `009bd651509a`: 1 breaking, 1 info - added `#/components/schemas/TranscriptionOrderItemRequest` to the `items/items/item` response property `oneOf` list for the response status `200` - added `transcription` discriminator mapping keys to the `items/items/item` response property for the response status `200` - **2026-06-08** `37fac3c5a2d7`: 1 info - endpoint added [Operation history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/productions/orders/:order_id/get.md) --- [API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) - [All operations](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/revisions/0e2bfc751634?raw)