Fetch all videos
GET {{baseUrl}}/videos
This operation shows details for all videos available in Wowza Video.
Request Params
Key | Datatype | Required | Description |
---|
page | number | | Returns a paginated view of results from the HTTP request. Specify a positive integer to indicate which page of the results should be displayed. The default is 1. |
per_page | number | | For use with the page parameter. Indicates how many records should be included in a page of results. A valid value is any positive integer. The default and maximum value is 1000. |
created_at | string | | Filter the response based on an asset's timespan. The filter can be specified in following formats: |
Spec | Description |
---|
YYYY-MM-DD'T'HH:mm:ss | Returns all assets with created_at after the specified date |
| |
updated_at | string |
Spec | Description |
---|
YYYY-MM-DD'T'HH:mm:ss | Returns all assets with updated_at after the specified date |
| |
published_at | string |
Spec | Description |
---|
YYYY-MM-DD'T'HH:mm:ss | Returns all assets with published_at after the specified date |
| |
state | string |
State | Description |
---|
UPLOADING | The source file is currently being uploaded or waiting to be downloaded by our API. |
WAITING_FOR_ENCODER | The source file was successfully downloaded by the platform and is in queue to be encoded. |
PROCESSING | Source file for the asset is encoding. The current encoding progress can be found on encoding_progress property. |
FINISHED | The encoding is done and the encoded files can be fetched. In this state it's possible to embed the video. |
ERROR | If the platform, for some reason, could not download the source file or failed during the encoding process. error_messsage property can give more information about why it errored. |
DELETED | The video files have been deleted. Usually the video asset have been deleted when this state is reached and because of that it's very uncommon to see assets with this state. |
| |
query | string |
It searches name
, description
, tags
searches all your custom fields for matching terms.
You can search specific fields by specifying them after a colon (:
); if you have multiple search terms you can use pipe
(|
) to separate the search terms.
Some examples:
Query | Description |
---|
query=foo | Searches all fields for foo . |
| |
sort_column | string |
sort_direction | string |
Key | Datatype | Required | Description |
---|
Accept | string | | |
RESPONSES
status: OK
{"videos":[{"id":"2aa3343e-2fb5-42c3-8671-b52c24b7c3e2","name":"My video","description":"A new video for my business.","duration_in_ms":12751628,"unpublish":true,"unpublished_at":"2025-01-01T12:33:22Z","published":true,"published_at":"2024-01-01T12:33:22Z","tags":["foo","bar"],"category_id":"\u003cThe account's default category\u003e","no_ads":false,"ad_keywords":"special_ads","created_at":"2024-01-01T12:33:22Z","updated_at":"2024-01-01T12:33:22Z","state":"FINISHED"},{"id":"2aa3343e-2fb5-42c3-8671-b52c24b7c3e2","name":"My video","description":"A new video for my business.","duration_in_ms":-56777622,"unpublish":true,"unpublished_at":"2025-01-01T12:33:22Z","published":false,"published_at":"2024-01-01T12:33:22Z","tags":["foo","bar"],"category_id":"\u003cThe account's default category\u003e","no_ads":true,"ad_keywords":"special_ads","created_at":"2024-01-01T12:33:22Z","updated_at":"2024-01-01T12:33:22Z","state":"FINISHED"}],"pagination":{"payload_version":80380108.57641292,"total_records":100,"page":1,"per_page":10,"total_pages":2,"page_first_index":10,"page_last_index":10}}