Unit API

GET /unit/search

List of available units

Example request:

GET /unit/search?unit_id[]=127&unit_id[]=9&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.net

Example response:

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 243
Connection: keep-alive
Date: Thu, 01 Jan 2026 01:46:03 GMT
Content-encoding: gzip
Server: Apache
Access-control-allow-origin: *
Vary: Accept-Encoding
X-cache: Miss from cloudfront
Via: 1.1 0dc812a83c1e947b351f1eb1761c3c94.cloudfront.net (CloudFront)
X-amz-cf-pop: IAD61-P12
Alt-svc: h3=":443"; ma=86400
X-amz-cf-id: TyMCu78WP0VyShIwxYJUZ7Y175f-CrPh-CpSKI3WPBtBiNx3QmNCGQ==

{
    "messages":[
        "max_results was not supplied.  A maximum of 50 results per page will be returned."
    ],
    "page_info":{
        "total_results":2,
        "results_per_page":50
    },
    "results":[
        {
            "id":"9",
            "unit_name":"139th Mobile Public Affairs Detachment",
            "unit_abbrev":"139MPAD",
            "branch":"Army"
        },
        {
            "id":"127",
            "unit_name":"DVIDS Hub",
            "unit_abbrev":"DVIDSHUB",
            "branch":"Joint"
        }
    ]
}

Query Parameters:

  • api_key: Public API access key issued by DVIDS (key-xxxxxxxxxxxxx)
  • sortdir: One of asc, desc.
  • unit_id: [int] Unit id to retrieve contents for. | unit_id=127 | &unit_id[]=127&unit_id[]=43
  • branch: Branch name to retrieve contents for.
  • max_results: Maximum number of results to return.
  • unit_abbrev: | DVIDS abbreviation of unit credited with media asset.| unit_abbrev=DVIDSHUB | &unit_abbrev[]=DVIDSHUB&unit_abbrev[]=AFNA
  • unit_name | Full or partial name of unit.| unit_name=DVIDS hub | unit_name=DVIDS |
  • page: [int] What page to load. Defaults to 1.

Status Codes:

  • 200: no error
  • 400: invalid parameter(s) specified. See errors element in response for details.
  • 403: api_key not provided, invalid, or accessed from origin (protocol+domain) other than the one associated with the key provided.

Response Fields:

  • unit_id: Id for the unit
  • unit_name: name of the unit
  • unit_abbrev: Abbrevation for the unit
  • branch: Name of branch for the unit