GET https://api.vidyard.com/dashboard/v1/videos/:video_id/captions
Gets all captions for a video that satisfies the provided filtering and sorting parameters (if any)

Given a valid video ID, and optional filtering and sorting parameters, retrieves the captions associated with the video that satisfy the parameters

Supported Formats

json

Errors

Code Description
400 Bad Request: body has wrong syntax or unable to handle request
401 Unauthorized: auth_token omitted or authentication failed
403 Forbidden: This action cannot be performed
404 Not Found: The requested resource could not be found
406 Not Acceptable: Accept or Content-Type headers must be application/json, text/csv or application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
422 Unprocessable Entity: body has wrong attributes

Examples

RESPONSE
Content-Type: application/json
[
  {
    "srt_url": "//cdn.vidyard.com/transcriptions/BeQAX/i-UTPAWS.srt",
    "vtt_url": "//cdn.vidyard.com/transcriptions/BeQAX/Yut9l8z4.vtt",
    "txt_url": "//cdn.vidyard.com/transcriptions/BeQAX/Yut9l8z4.txt",
    "language": "en",
    "id": 1011,
    "status": "complete",
    "created_at": 1442297000,
    "updated_at": 1442297001,
    "formatted_language_name": "English (en)",
    "localized_language_name": "English",
    "is_default": true,
    "notes": "Transcription request notes",
    "srt_download_url": "//vidyard.s3.amazonaws.com/transcriptions/BeQAX/i-UTPAWS.srt",
    "vtt_download_url": "//vidyard.s3.amazonaws.com/transcriptions/BeQAX/Yut9l8z4.vtt",
    "txt_download_url": "//vidyard.s3.amazonaws.com/transcriptions/BeQAX/Yut9l8z4.txt",
  },
  {
    "srt_url": "//cdn.vidyard.com/transcriptions/BeQAX/i-UTPAWS.srt",
    "vtt_url": "//cdn.vidyard.com/transcriptions/BeQAX/Yut9l8z4.vtt",
    "txt_url": "//cdn.vidyard.com/transcriptions/BeQAX/Yut9l8z4.txt",
    "language": "fr",
    "id": 1011,
    "status": "complete",
    "created_at": 1442297000,
    "updated_at": 1442297001,
    "formatted_language_name": "Francais (fr)",
    "localized_language_name": "Francais",
    "is_default": false,
    "notes": "",
    "srt_download_url": "//vidyard.s3.amazonaws.com/transcriptions/BeQAX/z-X1PAWS.srt",
    "vtt_download_url": "//vidyard.s3.amazonaws.com/transcriptions/BeQAX/Yut7l8z4.vtt",
    "txt_download_url": "//vidyard.s3.amazonaws.com/transcriptions/BeQAX/Yut9l8z4.txt",
  }
]
RESPONSE
Code: 404
Content-Type: application/json
{
  "error": "404: No video exists with that id"
}

Params

Param name Description
auth_token
optional

API token needed to authorize requests
This can appear as an attribute in the body of the request or the query parameters on the URL

Validations:

  • Must be a String
language
optional

two letter language code used to return the first caption with the matching language code

Validations:

  • Must be a String
order_by
optional

The attribute to order the list by

Validations:

  • Must be one of: language, created_at, updated_at.
direction
optional

Given an valid order_by value, determines the direction to order the list

Validations:

  • Must be one of: asc, desc.

Returns

Code: 200

Description:

All captions associated with the video given filtering and sorting options applied (if any)

Param name Description
srt_url
required

The URI of the SRT-formatted version of the caption

Validations:

  • Must be a String
vtt_url
required

The URI of the VTT-formatted version of the caption

Validations:

  • Must be a String
txt_url
required

The URI of the TXT-formatted version of the caption

Validations:

  • Must be a String
language
required

The language locale code indicating the language the caption is in

Validations:

  • Must be a String
id
required

The internal ID of the caption

Validations:

  • Parameter has to be Integer.
status
required , nil allowed

The current state of the caption

Validations:

  • Must be one of: captioning, complete, draft, error, initializing, in_process, in_progress, published, saving, transcribing.
created_at
required

The timestamp when the caption was created

Validations:

  • Must be a DateTime
updated_at
required

The timestamp when the caption was last updated

Validations:

  • Must be a DateTime
formatted_language_name
required

The name of the language in which the caption was formatted

Validations:

  • Must be a String
localized_language_name
required

The name of the language in which the caption was localized

Validations:

  • Must be a String
is_default
required

Indicates whether or not this is the default caption for the associated video

Validations:

  • Must be one of: true, false, 1, 0.
notes
required

Additional notes created for the user about the caption

Validations:

  • Must be a String
srt_download_url
required

A fully qualified URL from which the SRT-formatted version of the caption can be downloaded

Validations:

  • Must be a String
vtt_download_url
required

A fully qualified URL from which the VTT-formatted version of the caption can be downloaded

Validations:

  • Must be a String
txt_download_url
required

A fully qualified URL from which the TXT-formatted version of the cpation can be downloaded

Validations:

  • Must be a String
creator_type
required

Indicates if the caption was created automatically or manually

Validations:

  • Must be one of: Automatic, Manual.

Code: 404

Description:

A message indicating why the caption could not be created

Param name Description
error
required

A contextual error message when a request could not be completed

Validations:

  • Must be a String