---
title: "Get File Status"
method: GET
path: "/v2/files/{file_uuid}/status"
tags: ["Files"]
---

# Get File Status

`GET /v2/files/{file_uuid}/status`

Check processing status for a file. Use this to poll video processing progress.

Args:
    file_uuid (str): UUID of the file to check status for.

Returns:
    FileStatusResponse: Contains:
        - processing_status: "pending", "processing", "completed", or "failed"
        - error_message: If status is "failed", contains error details
        - remote_file_path: Available when status is "completed"

Use this endpoint to poll until processing_status == "completed" before calling
GET /files/{file_uuid}/frames for video files.

Example:
    GET /api/v2/files/{file_uuid}/status

## Path parameters

- `file_uuid` string, required

## Response `200`

OK

- FileStatusResponse — Schema for file processing status endpoint.
  - `file_uuid` string, required — Unique identifier for the file.
  - `processing_status` string, required — Current processing status: pending, processing, completed, or failed.
  - `error_message` string, nullable — Error message if processing failed.
  - `remote_file_path` string, nullable — S3 path to the file (available when completed).
  - `created_at` string, date-time, required — Timestamp when the file was created.
  - `updated_at` string, date-time, required — Timestamp when the file was last updated.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/aymara-ai/apis/aymara-api.md) · [All operations](https://skmtc.net/aymara-ai/apis/aymara-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aymara-ai/aymara-api/versions/0cb64ef11adf/schema)