---
title: "List caption requests"
method: GET
path: "/caption_file_requests"
tags: ["Professional captioning"]
---

# List caption requests

`GET /caption_file_requests`

This endpoint lists caption requests. It works both with auth token and the captioning service auth headers.

## Query parameters

- `provider` 'professional', required
- `status` 'requested', required

## Response `200`

List of caption requests

- object
  - `caption_file_requests` object[]
    - `media_id` string
    - `job_name` string
    - `language` string
    - `media_url` string
    - `format` string
    - `callback_url` string
    - `provider` string
    - `status` string
    - `captioning_service_id` integer
    - `service_type_key` string

## Other responses

- `401` — Authorization information is missing or invalid.
- `403` — If a user without proper permissions tries to call this endpoint, the call is rejected with 403 Forbidden.
- `422` — Invalid parameters.

---

[API](https://skmtc.net/instructure/apis/studio-public-api.md) · [All operations](https://skmtc.net/instructure/apis/studio-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instructure/studio-public-api/revisions/4838a5113869/schema)