---
title: "Resolve a recording and its transcript availability"
method: GET
path: "/api/transcripts/availability"
tags: ["discovery"]
---

# Resolve a recording and its transcript availability

`GET /api/transcripts/availability`

## Request

- Base URL: `https://transcripts.un.org`
- URL: `https://transcripts.un.org/api/transcripts/availability`
- Auth: none declared
- TypeScript: <https://skmtc.dev/united-nations/apis/un-transcripts-api/docs/api/transcripts/availability/get.ts> (a function with typed inputs; its response is checked against the schema)

Lightweight, public CORS endpoint. Pass exactly one identifier. Asset and player IDs are unique; canonical entry IDs may return multiple matches because several WebTV assets can redirect to the same Kaltura media. Valid unknown identifiers return an empty matches array and a safe Transcripts landing-page generationUrl.

## Query parameters

- `assetId` string
- `webtvUrl` string, uri
- `kalturaId` string
- `entryId` string
- `locale` 'ar' | 'zh' | 'en' | 'fr' | 'ru' | 'es'

## Response `200`

Resolution result, including zero or more matches.

- TranscriptAvailabilityResponse
  - `query` object, required
    - `type` 'assetId' | 'kalturaId' | 'entryId', required
    - `value` string, required
  - `generationUrl` string, required: Exact meeting page for one match; locale landing page when unresolved or ambiguous.
  - `matches` object[], required
    - `assetId` string, required
    - `kalturaId` string, required
    - `entryId` string, nullable, required
    - `removed` boolean, required
    - `pvSymbol` string, nullable, required
    - `pvPart` integer, nullable, required
    - `pageUrl` string, required
    - `jsonUrl` string, required
    - `generationUrl` string, required
    - `status` 'available' | 'processing' | 'unavailable' | 'removed', required
    - `languages` object[], required
      - `language` string, required
      - `status` 'scheduled' | 'transcribing' | 'identifying_speakers' | 'analyzing_topics' | 'completed' | 'no_content' | 'error' | 'interrupted', required
      - `transcriptId` string, required

## Other responses

- `400`: Missing, multiple, or malformed identifiers/locale.

---

[API](https://skmtc.dev/united-nations/apis/un-transcripts-api.md) - [All operations](https://skmtc.dev/united-nations/apis/un-transcripts-api/llms.txt) - [OpenAPI document](https://skmtc.dev/united-nations/apis/un-transcripts-api/revisions/fec86055cb63?raw)