Get Categories

The Dynamic Health API GET /content/categories endpoint returns a list of categories and hierarchies based on the categoryPath query parameter passed in. The /content/categories endpoint is a good starting point for someone who is not very familiar with the Dynamic Health content set. The endpoint can retrieve categories available in Dynamic Health that match the supplied path. The results will return categories that can be used to get content or search for the terms against the Dynamic Health content set. The /content/categories endpoint provides two parameters for specifying the search criteria: the category path and shallow, which is a boolean and determines if only top level results (true) will be returned or if the child paths (false) will be returned. 

To Perform a Categories Query (example):

Gather the following information for the request:

• An access token. Please see Use the Client Credentials Grant for further information.
• A content path.

Request

https://apis.ebsco.com/medsapi-dynamic-health/v1/content/categories?shallow=true&categoryPath=Skills|Nursing Skills

The request above is for categories for the 'Skills|Nursing Skills'. The request specifies to search for categories in Dynamic Health content that fall under this path and to only return the top-level results.

Response

 {
  "_metadata": {
    "totalItems": 1,
    "links": [
      {
        "rel": "self",
        "href": "https://apis.ebsco.com/medsapi-dynamic-health/v1/content/categories?shallow=false&categoryPath=Skills%7CNursing%20Skills"
      }
    ]
  },
  "items": [
    {
      "title": "Specialties",
      "categoryPath": "Skills|Nursing Skills|Specialties",
      "hasChildren": true,
      "children": [
        {
          "title": "Cardiovascular Care",
          "categoryPath": "Skills|Nursing Skills|Specialties|Cardiovascular Care",
          "hasChildren": true,
          "children": [
            {
              "title": "EKG",
              "categoryPath": "Skills|Nursing Skills|Specialties|Cardiovascular Care|EKG",
              "hasChildren": false
            }
          ]
        }
      ]
    }
  ]
}

Error Response Codes

Error response codes that can be received by all MedsAPIs are common.  See the error response codes section for details.