--- updatedAt: 2026-04-20T20:26:21.000Z agentTools: projectIndex: https://docs.wistia.com/llms.txt --- # List Localizations Lists all the localizations for a media. ## Requires api token with one of the following permissions ``` Read all data ``` Tokens with the "Act with a team member's permissions" permission (`all:delegate_to_contact_permissions` scope) can also be used. Requests made with such a token are authorized using the permissions of the contact assigned to the token. An [expiring access token](https://docs.wistia.com/reference/post_expiring-token) created with the `all:delegate_to_contact_permissions` scope and an authorization granting the `edit-transcripts` permission on the source media can also be used. Other media permissions do not reach a media's localizations, so a token without `edit-transcripts` lists none. # OpenAPI definition ````json { "openapi": "3.1.1", "info": { "title": "Data API", "description": "Wistia Data API", "version": "2026.09.0" }, "servers": [ { "url": "https://api.wistia.com/modern" } ], "security": [ { "BearerAuth": [] } ], "tags": [ { "name": "Localizations" } ], "paths": { "/medias/{mediaHashedId}/localizations": { "get": { "summary": "List Localizations", "x-speakeasy-group": "localizations", "x-speakeasy-name-override": "list", "description": "Lists all the localizations for a media.\n\n## Requires api token with one of the following permissions\n```\nRead all data\n```\n\nTokens with the \"Act with a team member's permissions\" permission\n(`all:delegate_to_contact_permissions` scope) can also be used. Requests\nmade with such a token are authorized using the permissions of the\ncontact assigned to the token.\n\nAn [expiring access token](https://docs.wistia.com/reference/post_expiring-token)\ncreated with the `all:delegate_to_contact_permissions` scope and an\nauthorization granting the `edit-transcripts` permission on the source\nmedia can also be used. Other media permissions do not reach a media's\nlocalizations, so a token without `edit-transcripts` lists none.\n", "parameters": [ { "name": "mediaHashedId", "in": "path", "description": "The hashed ID of the media to list localizations for.", "required": true, "schema": { "type": "string" } }, { "name": "include_transcript", "in": "query", "description": "Whether to include the transcript in the response.", "required": false, "schema": { "type": "boolean", "default": false } }, { "name": "X-Wistia-API-Version", "in": "header", "required": true, "schema": { "type": "string", "default": "2026-09" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "array", "items": { "unevaluatedProperties": false, "allOf": [ { "type": "object", "description": "A localization is a translation of a media into another language.\n", "properties": { "hashed_id": { "description": "A unique alphanumeric identifier for this localization.", "type": "string" }, "language_code": { "description": "A 3-character language code as specified by IETF.", "type": "string" }, "iso639_2_language_code": { "description": "A 2-character language code as specified by ISO-639–2.", "type": "string" }, "language_name": { "description": "The name of the language in English.", "type": "string" }, "native_language_name": { "description": "The name of the language in the language of the localization.", "type": "string" }, "created_at": { "description": "The date when the localization was created.", "type": "string", "format": "date-time" }, "updated_at": { "description": "The date when the localization was last updated.", "type": "string", "format": "date-time" }, "ordered_at": { "description": "The date when the localization was ordered.", "type": [ "string", "null" ], "format": "date-time" }, "enabled_at": { "description": "The date when the localization was enabled.", "type": [ "string", "null" ], "format": "date-time" }, "enabled": { "description": "Whether or not the localization is enabled.", "type": "boolean" }, "source_media": { "unevaluatedProperties": false, "type": "object", "description": "The media that the localization is associated with.", "properties": { "hashed_id": { "description": "A unique alphanumeric identifier for this media.", "type": "string" }, "name": { "description": "The name of the media.", "type": "string" }, "duration": { "description": "The duration of the media in seconds.", "type": "number" }, "created_at": { "description": "The date when the media was created.", "type": "string", "format": "date-time" }, "updated_at": { "description": "The date when the media was last updated.", "type": "string", "format": "date-time" } }, "required": [ "hashed_id", "name", "duration", "created_at", "updated_at" ] }, "transcript": { "unevaluatedProperties": false, "type": [ "object", "null" ], "description": "The transcript for the localization. Selectively serialized in some endpoints. See properties for endpoint.", "properties": { "hashed_id": { "description": "A unique alphanumeric identifier for this transcript.", "type": "string" }, "language_name": { "description": "The name of the language in English.", "type": "string" }, "native_language_name": { "description": "The name of the language in the language of the localization.", "type": "string" }, "text": { "description": "The text of the transcript.", "type": "string" }, "created_at": { "description": "The date when the transcript was created.", "type": "string", "format": "date-time" }, "updated_at": { "description": "The date when the transcript was last updated.", "type": "string", "format": "date-time" } }, "required": [ "hashed_id", "language_name", "native_language_name", "text", "created_at", "updated_at" ] } }, "required": [ "hashed_id", "language_code", "iso639_2_language_code", "language_name", "native_language_name", "created_at", "updated_at", "ordered_at", "enabled_at", "enabled", "source_media" ] } ] } } } } }, "401": { "description": "Unauthorized, invalid or missing token", "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "properties": { "code": { "description": "A machine-readable identifier for the specific authorization failure.", "type": "string", "enum": [ "unauthorized_credentials", "account_inactive", "unauthorized_scope", "unauthorized_params" ] }, "error": { "type": "string", "examples": [ "Invalid credentials." ] } } } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "properties": { "error": { "type": "string", "examples": [ "Folder with ID 'fakeid' not found." ] } } } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "properties": { "error": { "type": "string", "examples": [ "Internal server error" ] } } } } } } }, "tags": [ "Localizations" ], "x-readme": { "code-samples": [ { "name": "Typescript (SDK)", "language": "javascript", "code": "import { Wistia } from \"@wistia/wistia-api-client\";\n\nconst wistia = new Wistia({\n bearerAuth: process.env[\"WISTIA_BEARER_AUTH\"] ?? \"\",\n});\n\nasync function run() {\n const result = await wistia.localizations.list({\n mediaHashedId: \"\",\n });\n\n console.log(result);\n}\n\nrun();" } ] } } } }, "components": { "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer" } } }, "x-readme": { "samples-languages": [ "javascript", "shell", "node", "python", "ruby" ] } } ````