Utah.gov

The search API allows developers to query against the Utah.gov indexed database. Use this to pull all or any of our various types and categories. The following document outlines sample sample code, parameters, and a type and category legend for making your queries.

Parameters

• keyword
• categoryIds

  You can pass multiple category ids. For example, to get data back for 'Health' and 'Hospitals & Medical Care' you would pass: '16,61'. See below for a complete list of category ids.

• typeIds

  See below for a complete list of type ids.

• limit

Sample Query

curl -H "Accept:application/json" "http://www.utah.gov/masterindex/search.json?keyword=oil&typeIds=17&categoryIds=12&limit=50"

This query pulls all the CSV files (typeIds 17) that match the category of Environmental Protection (categoryIds 12) and include the keyword "oil" and limits the results to 50.

Sample Result (jSON)

{
   "results":[
      {
         "agencies":[

         ],
         "categories":[
            "Environmental Protection"
         ],
         "description":"Utah Refinery Receipts of Crude Oil by State of Origin, 1960-2008",
         "governmentClass":"state",
         "imageName":"",
         "name":"Utah Refinery Receipts of Crude Oil",
         "type":"CSV",
         "url":"http://geology.utah.gov/emp/energydata/oildata.htm"
      },
      {
         "agencies":[

         ],
         "categories":[
            "Environmental Protection"
         ],
         "description":"Soil sampling data from across the state of Utah.",
         "governmentClass":"state",
         "imageName":"",
         "name":"Utah Core Research Sample Catalog",
         "type":"CSV",
         "url":"http://geology.utah.gov/emp/ucrc/ucrcfullcatalogue_13Jan09.txt"
      }
   ],
   "topAgency":"Department of Natural Resources",
   "totalCount":2
}
	

Types

Categories

General Note

All of our APIs are accessible with all server side programming languages. JavaScript requests will not work.