api.video
  1. Videos
api.video
  • Account
    • Show account
      GET
  • Analytics
    • List live stream player sessions
      GET
    • List player session events
      GET
    • List video player sessions
      GET
  • Authentication
    • Authenticate
      POST
    • Refresh token
      POST
  • Live
    • List all live streams
      GET
    • Create live stream
      POST
    • Delete a live stream
      DELETE
    • Show live stream
      GET
    • Update a live stream
      PATCH
    • Delete a thumbnail
      DELETE
    • Upload a thumbnail
      POST
  • Players
    • List all players
      GET
    • Create a player
      POST
    • Delete a player
      DELETE
    • Show a player
      GET
    • Update a player
      PATCH
    • Delete logo
      DELETE
    • Upload a logo
      POST
  • Videos - Delegated upload
    • Upload with an upload token
    • List all active upload tokens.
    • Generate an upload token
    • Delete an upload token
    • Show upload token
  • Videos
    • List all videos
      GET
    • Create a video
      POST
    • Delete a video
      DELETE
    • Show a video
      GET
    • Update a video
      PATCH
    • Upload a video
      POST
    • Show video status
      GET
    • Pick a thumbnail
      PATCH
    • Upload a thumbnail
      POST
  • Captions
    • List video captions
    • Delete a caption
    • Show a caption
    • Update caption
    • Upload a caption
  • Chapters
    • List video chapters
    • Delete a chapter
    • Show a chapter
    • Upload a chapter
  • Webhooks
    • List all webhooks
    • Create Webhook
    • Delete a Webhook
    • Show Webhook details
  1. Videos

Show video status

GET
/videos/{videoId}/status
This API provides upload status & encoding status to determine when the video is uploaded or ready to playback. Once encoding is completed, the response also lists the available stream qualities. Tutorials using video status.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://ws.api.video/videos/vi4k0jvEUuaTdRAEjQ4Jfrgz/status'
Response Response Example
200 - response
{
    "encoding": {
        "metadata": {
            "aspectRatio": "16/9",
            "audioCodec": "aac",
            "bitrate": 411.218,
            "duration": 4176,
            "framerate": 24,
            "height": 240,
            "samplerate": 48000,
            "videoCodec": "h264",
            "width": 424
        },
        "playable": true,
        "qualities": [
            {
                "quality": "360p",
                "status": "encoded"
            },
            {
                "quality": "480p",
                "status": "encoded"
            },
            {
                "quality": "720p",
                "status": "encoded"
            },
            {
                "quality": "1080p",
                "status": "encoding"
            },
            {
                "quality": "2160p",
                "status": "waiting"
            }
        ]
    },
    "ingest": {
        "filesize": 273579401,
        "receivedBytes": [
            {
                "from": 0,
                "to": 134217727,
                "total": 273579401
            },
            {
                "from": 134217728,
                "to": 268435455,
                "total": 273579401
            },
            {
                "from": 268435456,
                "to": 273579400,
                "total": 273579401
            }
        ],
        "status": "uploaded"
    }
}

Request

Path Params

Responses

🟢200Success
application/json
Body

🟠404Not Found
Modified at 2023-08-15 05:52:15
Previous
Upload a video
Next
Pick a thumbnail
Built with