---
title: "Read a workspace scoped language discovery"
method: GET
path: "/v1/language-discoveries/{id}"
tags: ["jobs"]
---

# Read a workspace scoped language discovery

`GET /v1/language-discoveries/{id}`

## Request

- Base URL: `https://api.transcriptdock.com`
- URL: `https://api.transcriptdock.com/v1/language-discoveries/{id}`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `sb-access-token`

## Path parameters

- `id` string, uuid, required

## Response `200`

Discovery status and exact source language inventory

- LanguageDiscovery
  - `id` string, uuid, required
  - `status` 'queued' | 'processing' | 'succeeded' | 'failed', required
  - `source` object, required
    - `platform` 'youtube', required
    - `media_id` string, required
    - `canonical_url` string, uri, required
  - `languages` LanguageDiscoveryLanguage[], required
    - `code` string, required
    - `display_name` string, required
    - `native_name` string, required
    - `origin` 'creator' | 'automatic', required
    - `is_original` boolean, required
    - `is_default` boolean, required
    - `timed_text` boolean, required
  - `default_language` string, nullable, required
  - `original_language` string, nullable, required
  - `error` ErrorObject, required
    - `code` 'INVALID_REQUEST' | 'INVALID_URL' | 'INVALID_CURSOR' | 'UNSUPPORTED_SOURCE' | 'UNSUPPORTED_MEDIA' | 'CAPABILITY_UNAVAILABLE' | 'UNAUTHENTICATED' | 'FORBIDDEN' | 'EMAIL_UNVERIFIED' | 'NOT_FOUND' | 'INSUFFICIENT_BALANCE' | 'PLAN_REQUIRED' | 'BUDGET_EXCEEDED' | 'IDEMPOTENCY_CONFLICT' | 'JOB_NOT_RETRYABLE' | 'CANCELLATION_NOT_ALLOWED' | 'RATE_LIMITED' | 'SOURCE_NOT_FOUND' | 'SOURCE_PRIVATE' | 'SOURCE_AUTH_REQUIRED' | 'SOURCE_REGION_RESTRICTED' | 'NO_CAPTIONS' | 'LANGUAGE_UNAVAILABLE' | 'LANGUAGE_UNSUPPORTED' | 'NO_SPEECH' | 'NO_AUDIO' | 'TIMESTAMPS_UNAVAILABLE' | 'DURATION_LIMIT_EXCEEDED' | 'FILE_TOO_LARGE' | 'UNSAFE_URL' | 'INVALID_MEDIA' | 'SOURCE_RATE_LIMITED' | 'SOURCE_BLOCKED' | 'SOURCE_TIMEOUT' | 'SOURCE_CHANGED' | 'PROVIDER_UNAVAILABLE' | 'STORAGE_UNAVAILABLE' | 'PROVIDER_REJECTED' | 'INTERNAL_ERROR', required
    - `message` string, required
    - `retryable` boolean, required
    - `retry_after_seconds` integer
    - `details` object
    - `doc_url` string, uri: Where this code is documented.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `expires_at` string, date-time, nullable, required

---

[API](https://skmtc.dev/transcriptdock/apis/transcriptdock-api.md) · [All operations](https://skmtc.dev/transcriptdock/apis/transcriptdock-api/llms.txt) · [OpenAPI document](https://skmtc.dev/transcriptdock/apis/transcriptdock-api/revisions/7bda7594bdfd?raw)