# Inspect remote video metadata

Inspects a video hosted at a direct URL (e.g. Amazon S3, HTTPS)
and returns metadata required before starting a video import.

This step is mandatory before creating a transfer.

Endpoint: POST /inspector/get_metadata
Version: 1.0.0
Security: bearerAuth

## Request fields (application/json):

  - `url` (string, required)
    Direct URL to the source video
    Example: "https://bucket.s3.amazonaws.com/video.mp4"

## Response 200 fields (application/json):

  - `id` (string)
    Metadata identifier used for import
    Example: "tup_eK9_VlyyRnLr"

  - `duration` (number)
    Example: 312

  - `size` (number)
    Example: 104857600

  - `container` (string)
    Example: "mov"

  - `videoCodec` (string)
    Example: "h264"

  - `audioCodec` (string)
    Example: "aac"

## Response 400 fields (application/json):

  - `message` (string)
    Example: "Invalid request"

## Response 401 fields (application/json):

  - `message` (string)
    Example: "Invalid request"