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.
