---
title: "Query VHS video metadata"
method: GET
path: "/api/vhs/queryvideo"
tags: ["file"]
---

# Query VHS video metadata

`GET /api/vhs/queryvideo`

VHS custom node endpoint that returns metadata about a video file
(frame count, fps, resolution, duration). Currently returns default
placeholder values; real ffprobe integration is a follow-up.

## Query parameters

- `filename` string, required

## Response `200`

Video metadata

- object
  - `source` object, required — Source video metadata
    - `duration` number, required — Duration in seconds
    - `fps` number, required — Frames per second
    - `frames` integer, required — Total frame count
    - `size` integer[], required — [width, height] in pixels

## Other responses

- `400` — Missing required query parameter. Produced by the oapi-codegen wrapper via echo.NewHTTPError; the custom Echo HTTPErrorHandler normalizes it to the standard ErrorResponse {code, message} shape (BE-1178).
- `401` — Unauthorized

## Changes

> 38 revisions in range; 2 could not be searched.

- **2026-06-03** `8560879e6188` — 1 breaking, 2 warning, 11 info
  - removed the required property `error` from the response with the `401` status
  - deleted the `query` request parameter `subfolder`
  - deleted the `query` request parameter `type`
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - …10 more
- **2026-05-22** `09a5075587c8` — 2 info
  - api operation id `queryVhsVideo` removed and replaced with `getVhsQueryVideo`
  - added the non-success response with the status `400`
- **2026-05-08** `c9640fded659` — 1 info
  - endpoint added
- **2026-04-24** `a66055fa384e` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/comfy-org/apis/comfyui-api/changes/api/vhs/queryvideo/get.md)

---

[API](https://skmtc.dev/comfy-org/apis/comfyui-api.md) · [All operations](https://skmtc.dev/comfy-org/apis/comfyui-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/comfy-org/comfyui-api/revisions/da017caf56f1/schema)