Searching for Categories by ID
The DynaMed API GET /categories/{categoriesId} endpoint returns the category matching the id provided.
To Perform a Search for Categories by ID (example):
Gather the following information for the request:
- An access token. Please see Use the Client Credentials Grant for further information.
- A category ID. For version 1, this is the id returned from the v1 categories response, not the categoryId.
Request
GET https://apis.ebsco.com/medsapi-dynamed/v1/categories/cardiology
Response
{ "id": "cardiology", "title": "Cardiology", "links": [ { "rel": "self", "href": "https://apis.ebsco.com/medsapi-dynamed/v1/categories/cardiology" }, { "rel": "collection", "href": "https://apis.ebsco.com/medsapi-dynamed/v1/categories" } ], "children": [ { "title": "Acute Coronary Syndromes", "children": [ { "title": "Non-ST-elevation Acute Coronary Syndromes (NSTE-ACS)", "children": [ { "title": "Types", "resources": [ { "title": "Suspected Acute Coronary Syndrome", "slug": "/condition/suspected-acute-coronary-syndrome", "id": "T906417", "links": [ { "rel": "self", "href": "https://apis.ebsco.com/medsapi-dynamed/v1/articles/T906417" } ] }, { "title": "Acute Coronary Syndromes", "slug": "/condition/acute-coronary-syndromes", "id": "T116779", "links": [ { "rel": "self", "href": "https://apis.ebsco.com/medsapi-dynamed/v1/articles/T116779" } ] } ] }, { "title": "Management", "resources": [ { "title": "Antiplatelet and Anticoagulant Drugs for Acute Coronary Syndromes", "slug": "/management/antiplatelet-and-anticoagulant-drugs-for-acute-coronary-syndromes", "id": "T353497", "links": [ { "rel": "self", "href": "https://apis.ebsco.com/medsapi-dynamed/v1/articles/T353497" } ] } ] } ] } ] }, { "title": "Stable Coronary Artery Disease (CAD)", "children": [ { "title": "Testing and Approach", "resources": [ { "title": "Chest Pain in Adults - Approach to the Patient", "slug": "/approach-to/chest-pain-in-adults-approach-to-the-patient", "id": "T909990", "links": [ { "rel": "self", "href": "https://apis.ebsco.com/medsapi-dynamed/v1/articles/T909990" } ] } ] } ] } ] }
Error Response Codes
The DynaMed search for categories by ID endpoint can return one of the error response codes.