/live/listList of live events
Example request:
GET /live/list?max_results=2&api_key=key-XXXXXXXXXXXXX HTTP/1.1
Host: api.dvidshub.net
Accept-encoding: gzip, deflate
User-Agent: Zend_Http_Client
Accept: application/json, text/javascript
Referer: https://api.dvidshub.netExample response:
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 674
Connection: keep-alive
Date: Thu, 27 Aug 2026 05:31:41 GMT
Content-encoding: gzip
Server: Apache
Access-control-allow-origin: *
Vary: Accept-Encoding
X-cache: Miss from cloudfront
Via: 1.1 ecaa6567b96ae3a6069400ba39167766.cloudfront.net (CloudFront)
X-amz-cf-pop: IAD61-P12
Alt-svc: h3=":443"; ma=86400
X-amz-cf-id: ozKSCCpLCBqnPf3J-crrgwZNY7ZhuLB2PGv9oQZ79hK4ByNZxMR_bQ==
{
"results":[
{
"type":"live_webcasts",
"id":"38305",
"title":"Official U.S. Navy RTC Boot Camp Graduation",
"description":"Official U.S. Navy RTC Boot Camp Graduation",
"hashtag":"",
"begin":"2026-08-27T13:05:00+00:00",
"end":"2026-08-27T16:00:00+00:00",
"thumbnail":{
"url":"https:\/\/d1ldvf68ux039x.cloudfront.net\/thumbs\/webcast\/dod_default\/122x92_q95.jpg",
"width":122,
"height":92
},
"url":"https:\/\/www.dvidshub.net\/webcast\/38305",
"hls_url":"https:\/\/d1b55jk78a7el0.cloudfront.net\/out\/v1\/1d4a1a50b52b4333894d00ce0c4c7ca5\/index.m3u8",
"unit_id":"5124"
},
{
"type":"live_webcasts",
"id":"38377",
"title":"Defense Information School (DINFOS) Change of Command: Col. McNorton Relinquishes Command to Col. Bocanegra \u2013 August 27, 2026",
"description":"The Defense Information School Change of Command honoring Col. Richard J. McNorton, Acting Director, War Media Activity, and Commandant, Defense Information School. \r\n\r\nThe ceremony will recognize Col. McNorton\u2019s distinguished service and leadership and mark the transition of command to Col. Jennifer J. Bocanegra.",
"hashtag":"",
"begin":"2026-08-27T13:35:00+00:00",
"end":"2026-08-27T16:00:00+00:00",
"thumbnail":{
"url":"https:\/\/d1ldvf68ux039x.cloudfront.net\/thumbs\/webcast\/dod_default\/122x92_q95.jpg",
"width":122,
"height":92
},
"url":"https:\/\/www.dvidshub.net\/webcast\/38377",
"hls_url":"https:\/\/dch5nxbjiciir.cloudfront.net\/out\/v1\/3deaf7e071eb4d01b11da5fbf5d4a00c\/index.m3u8",
"unit_id":"318"
}
],
"current_time":"2026-08-27T05:31:41+00:00"
}api_key: Public API access key issued by DVIDS (key-xxxxxxxxxxxxx)
from_date: Specify a date/time in ISO8601 format to return events newer than from_date
has_video_id: [1] If set only return events that have a video_id associated with it
hashtag: If set only return events with that hashtag specified
max_results: [1-50] Maximum number of results to return per page. Default and maximum value are both 50.
prettyprint: [1] Spaces out JSON response in more readable format useful for debugging
sort: One of begin, end
sortdir: One of asc, desc
thumb_width: [1-2000] Width of thumbnail in pixels. If thumb_height is provided, this defaults to the aspect ratio native width of the asset relative to the height requested. Otherwise the resolution is 122x92. Max of 2000.
thumb_height: [1-2000] Height of thumbnail in pixels. If thumb_width is provided, this defaults to the aspect ratio native height of the asset relative to the width requested. Otherwise the resolution is 122x92. Max of 2000.
thumb_quality: [1-100] Quality of generated thumbnail. Default is 95
to_date: Specify a date/time in ISO8601 format to return events older than to_date
/live/getGet additional details about live event including links to feed(s)
Example request:
GET /live/get?id=3852&api_key=key-XXXXXXXXXXXXX HTTP/1.1
Host: api.dvidshub.net
Accept-encoding: gzip, deflate
User-Agent: Zend_Http_Client
Accept: application/json, text/javascript
Referer: https://api.dvidshub.netExample response:
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 406
Connection: keep-alive
Date: Thu, 27 Aug 2026 05:31:42 GMT
Content-encoding: gzip
Server: Apache
Access-control-allow-origin: *
Vary: Accept-Encoding
X-cache: Miss from cloudfront
Via: 1.1 cded7f6feab5e981a7d2ac5d0ce86a38.cloudfront.net (CloudFront)
X-amz-cf-pop: IAD61-P12
Alt-svc: h3=":443"; ma=86400
X-amz-cf-id: yXSpw5VB6mBiR8StVRAhf62BBhFJ7x4Rdjmn3jGiZrs3UoOhXshWJA==
{
"current_time":"2026-08-27T05:31:42+00:00",
"results":{
"id":"3852",
"title":"US Department of State Press Briefing",
"description":"Marie Harf, US Department of State Deputy Spokesperson, will deliver the daily press briefing. Feed begins at 1:30 PM EDT. *** Time subject to change.",
"begin":"2014-04-03T17:25:00+00:00",
"end":"2014-04-03T19:48:00+00:00",
"hls_url":null,
"thumbnail":{
"url":"https:\/\/d1ldvf68ux039x.cloudfront.net\/thumbs\/frames\/video\/1404\/326950\/122x92_q95.jpg",
"width":122,
"height":92
},
"url":"https:\/\/www.dvidshub.net\/webcast\/3852",
"video_id":"326950",
"unit_id":"127"
}
}api_key: Public API access key issued by DVIDS (key-xxxxxxxxxxxxx)
fields: Comma separated list of which fields to return
id: [int] Id of of the live event
prettyprint: [1] Spaces out JSON response in more readable format useful for debugging
thumb_width: [1-2000] Width of thumbnail in pixels. If thumb_height is provided, this defaults to the aspect ratio native width of the asset relative to the height requested. Otherwise the resolution is 122x92. Max of 2000.
thumb_height: [1-2000] Height of thumbnail in pixels. If thumb_width is provided, this defaults to the aspect ratio native height of the asset relative to the width requested. Otherwise the resolution is 122x92. Max of 2000.
thumb_quality: [1-100] Quality of generated thumbnail. Default is 95
video_id: Returned if the current event has been linked to a video asset
