/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: 719
Connection: keep-alive
Date: Wed, 16 Sep 2026 09:34:59 GMT
Content-encoding: gzip
Server: Apache
Access-control-allow-origin: *
Vary: Accept-Encoding
X-cache: Miss from cloudfront
Via: 1.1 07176b2f022f6a02b10faecdd79ef1bc.cloudfront.net (CloudFront)
X-amz-cf-pop: IAD61-P12
Alt-svc: h3=":443"; ma=86400
X-amz-cf-id: UrrotNU_rbl4Llz1X2nVY-ZcXqPm5ZVObPWBHAkbJCDQfGs-IQ0Q7g==
{
"results":[
{
"type":"live_webcasts",
"id":"38439",
"title":"Washington Navy Yard Remembrance Ceremony 2026",
"description":"On Sept. 16, 2026, NAVSEA will pause to honor the twelve teammates lost during the tragic events of Sept. 16, 2013. The program also includes a solemn reading of the names of the twelve lives taken that day: \r\n \r\nMichael Arnold \u00b7 Martin Bodrog \u00b7 Arthur Daniels \u00b7 Sylvia Frasier \u00b7 Kathleen Gaarde \u00b7 John Johnson \u00b7 Mary Knight \u00b7 Frank Kohler \u00b7 Kisan Pandit \u00b7 Kenneth Proctor \u00b7 Gerald Read \u00b7 Richard Ridgell\r\n\r\n",
"hashtag":"",
"begin":"2026-09-16T12:00:00+00:00",
"end":"2026-09-16T12:45: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\/38439",
"hls_url":"https:\/\/ddz6nlcu5n9df.cloudfront.net\/out\/v1\/46ecf370d6124e038a3e2a01bdf4048e\/index.m3u8",
"unit_id":"8226"
},
{
"type":"live_webcasts",
"id":"38402",
"title":"CPO pinning ceremony",
"description":"CPO pinning ceremony",
"hashtag":"",
"begin":"2026-09-16T12:20:00+00:00",
"end":"2026-09-16T14:30: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\/38402",
"hls_url":"https:\/\/d1b55jk78a7el0.cloudfront.net\/out\/v1\/1d4a1a50b52b4333894d00ce0c4c7ca5\/index.m3u8",
"unit_id":"5124"
}
],
"current_time":"2026-09-16T09:34:59+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: Wed, 16 Sep 2026 09:34:59 GMT
Content-encoding: gzip
Server: Apache
Access-control-allow-origin: *
Vary: Accept-Encoding
X-cache: Miss from cloudfront
Via: 1.1 4647dc1c8001fa9f311935bafe4ec8c2.cloudfront.net (CloudFront)
X-amz-cf-pop: IAD61-P12
Alt-svc: h3=":443"; ma=86400
X-amz-cf-id: 7dtYFPbSepfrayhVLKX0OKAgUs54_KbI0o8vmEGJUOv7RixAam_dOw==
{
"current_time":"2026-09-16T09:34:59+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
