Fetch all videos

GET {{baseUrl}}/videos

This operation shows details for all videos available in Wowza Video.

Request Params

KeyDatatypeRequiredDescription
pagenumberReturns 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_pagenumberFor 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_atstringFilter the response based on an asset's timespan. The filter can be specified in following formats:
SpecDescription
YYYY-MM-DD'T'HH:mm:ssReturns all assets with created_at after the specified date
updated_atstring
SpecDescription
YYYY-MM-DD'T'HH:mm:ssReturns all assets with updated_at after the specified date
published_atstring
SpecDescription
YYYY-MM-DD'T'HH:mm:ssReturns all assets with published_at after the specified date
statestring
StateDescription
UPLOADINGThe source file is currently being uploaded or waiting to be downloaded by our API.
WAITING_FOR_ENCODERThe source file was successfully downloaded by the platform and is in queue to be encoded.
PROCESSINGSource file for the asset is encoding. The current encoding progress can be found on encoding_progress property.
FINISHEDThe encoding is done and the encoded files can be fetched. In this state it's possible to embed the video.
ERRORIf 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.
DELETEDThe 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.
querystring

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:

QueryDescription
query=fooSearches all fields for foo.
sort_columnstring
sort_directionstring

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

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}}