The DynaMed/DynaMedex API GET /v2/content/articles/{articleId} endpoint returns the article matching the article id provided. The article id is a required parameter for the endpoint. When using the v2 articles endpoint, you receive the latest content, which is NOT backward compatible with the v1 articles. Because of this, you should use the v2 endpoints (search, search suggestions or slugs) to ensure responses contain links to the v2 articles.

Basic Retrieving of an Article by ID

To Get a Basic Article (example):

Gather the following information for the request:

An access token. Please see Using the Client Credentials Grant for further information.
The article ID to retrieve.

Request

GET https://apis.ebsco.com/medsapi-dynamed/v2/content/articles/t115279

The request above is for article ID t115279.

Response

{
  "id": "t115279",
  "title": "Acne",
  "slug": "/condition/acne",
  "links": [
    {
      "href": "https://apis.ebsco.com/medsapi-dynamic-health/v2/content/articles/t12345",
      "rel": "self"
    }
  ],
  "metadata": {
    "DC.Type": "topic",
    "DC.Title": "Acne",
    "abstract": "Acne is a chronic skin condition characterized by noninflammatory open and/or closed comedones and inflammatory lesions.",
    "DC.Format": "XHTML",
    "copyright": "(C) Copyright 2026",
    "DC.Coverage": [
        "Dermatologic DisordersInflammatory and vesicular lesions (non-infectious)",
        "PediatricsDermatologic disorders",
        "Family MedicineGeneral adult medicineDermatological disordersAcne"
    ],
    "DC.IsPartOf": "GUID-FF5ED846-2754-4019-88A9-493350EA3838",
    "DC.Language": "en",
    "DC.Relation": [
        "article://T906456",
        "article://T912424",
        "article://T116636",
        "article://T116224",
        "article://T115217",
        "article://T1636661684483",
        "article://T1563539939972",
        "article://T1732665261009"
    ],
    "description": "Acne is a chronic skin condition characterized by noninflammatory open and/or closed comedones and inflammatory lesions.",
    "DC.Identifier": "GUID-944EB57C-4546-4A61-924E-713D3A3DB473",
    "DC.Date.Revised": "2017-06-27T00:00:00.000Z",
    "DC.rights.owner": "(C) Copyright 2026"
  },
  "toc": [
    {
        "title": "Overview and Recommendations",
        "anchor": "GUID-3E2BB624-A1C1-4C77-BF7A-19789BD87180",
        "children": [
            {
                "title": "Evaluation",
                "anchor": "OVERVIEW_EVALUATION"
            },
            {
                "title": "Management",
                "anchor": "OVERVIEW_MANAGEMENT"
            }
        ]
    }
  ],
  "sections": [
    {
      "anchor": "GUID-3E2BB624-A1C1-4C77-BF7A-19789BD87180",
 			"title": "Overview and Recommendations",
      "content": "<div class=\"body\"><p class=\"p\">Acne is a common skin condition of open and/or closed comedones (blackheads and whiteheads) and inflammatory papules, pustules, cysts, or nodules located on the face, neck, back or chest in adolescents and young adults. </p>\n</div>",
      "children": [
        {
          "anchor": "OVERVIEW_EVALUATION",
          "content": "<html>...</html>",
          "title": "Evaluation",
          "children": [
             "anchor": "OVERVIEW_BACKGROUND_SUBSECTION",
             "content": "<html>...</html>,
             "title": "Sub Section"
        }
      ]
    }
  ],
  "tablesContent": {
    "TOPIC_XFD_BTB_TYB__TABLE_ARN_MK2_TYB": "<?xml version=\\\"1.0\\\"?>< table>table data</table>"
  },
  "ancillary": {
    "algoritmIds": [
      "a55555"
    ],
    "consensusDetails": [
      {
        "anchor": "GUID-342C5BB2-451B-44EA-977C-EC127205856A__CONSENSUSDETAIL",
        "consensusNote": "<div>Content referenced with...</div>",
        "consensusPanel": "<div>Panel participants:</div>"
      }
    ],
    "contributors": {
       "revisedDate": "2018-07-17",
       "acpContributor": "American College of Physicians",
       "authors": [...],
       "editors": [
         {
           "degrees": "MD, FACC, FHFSA, FAHA",
           "firstName": "Anekwe E.",
           "lastName": "Onwuanyi",
           "affiliationText": "\"The Skin Clinic, Massachusetts, United States",
           "conflictsText": "Dr. Elpern declares no relevant conflicts of\\n interest.",
           "degrees": "MD, MPH, FACP",
           "label": "Topic Editor"
         }
      ],
      "reviewers": [...]
     },
    "revisedDate": "2017-06-27",
    "description": "Acne is a chronic skin condition characterized by noninflammatory open and/or closed comedones and inflammatory lesions.",
    "headerMetadata": {
      "boxedWarnings": [
        {
          "heading": "Intravenous (Powder for Solution)",
          "warnings": [
            "Hypersensitivity Reactions Including Anaphylaxis"
          ]
        }
      ],
      "classes": [
        "Enzyme"
      ],
      "routes": [
        "intravenous"
      ]
    },
    "imageIds": [
      "i505966"
    ],
    "multimedia": [
      {
        "content": [
          {
            "copyright": "Copyright 2023, Luke Danaher. Video courtesy of Luke Danaher and Radiopaedia.org. Used under licence.",
            "description": "Diagnostic Approach to Cystic Lung Disease",
            "links": [
              {
                "href": "https://media.ebsco.healthcare/video/authenticated/s--y2MpK4a9--/v1674665799/EBSCOHealth/CCMS/Dynamed/videos/V1674666001630.mp4",
                "imageSize": "medium",
                "posterSize": "small",
                "rel": "external",
                "type": "poster"
              }
            ],
            "publicId": "EBSCOHealth/CCMS/Dynamed/videos/V1674666001630",
            "mediaHost": "cloudinary",
            "title": "Birt-Hogg-Dubé syndrome. "
          }
        ],
        "mediaType": "video"
      }
    ],
    "tables": [
        {
            "id": "TOPIC_XFD_BTB_TYB__TABLE_ARN_MK2_TYB",
            "title": "Table 1:",
            "caption": "Investigator Global Assessment of Acne",
            "standAlone": true,
            "parentSection": "TOPIC_XFD_BTB_TYB"
        }
		],
    "pubDate": "2018-06-29",
    "pubType": {
      "id": "condition",
      "title": "Acne"
    },
    "relatedLinks": [
      "T902822",
      "T902797",
      "T908625",
      "T913033"
    ],
    "referenceLinks": [
      {
        "anchor": "GUID-C22B30D6-C077-4BDE-8547-F6C9F2DAE88A__AAD2016",
        "description": "<li>Eichenfield DZ<div data-title=\\\"JAMA 2021\\\" data-transform=\\\"full-text-container\\\" data-value=\\\"34812859\\\"><a href=\\\"http://pubmed.ncbi.nlm.nih.gov/34812859?dopt=Abstract\\\">PubMed Abstract</a></div>.</li>"
      }
    ],
    "revisedDate": "2019-07-29",
    "videoIds": [
      "V1674666001630"
    ],
    "updates": [
      {
        "text": "Heart Failure Society of America guideline on heart failure epidemiology and outcomes statistics (J Card Fail 2023 Oct)",
        "timestamp": "2023-10-18T00:47:05.000Z",
        "practiceChangingUpdate": false,
        "healthEquity": false,
        "nejmAdvantage": true,
        "updateType": "guidelineNotationUpdate",
        "updatePriority": "low",
        "anchor": "UNITED_STATES_GUIDELINES__LI_XR1_ZCK_DZBGNU101723"
      }
  }
}

Additional fields may be returned in the metadata.

Media within Articles

Responses can include items that have images, algorithms and/or videos. These include the title, copyright and a link to the actual image or video. By default, the image URL is a link to a full resolution image that is optimized for the browser making the request. See Media Responses for more details and limitations.

Specifying Image and Video Image Sizes

Links to images of varying sizes may be returned in the article response. To specify the image size, add one or more imageSize query parameters to the call. small (200w), medium (500w) and large (1000w) image sizes are supported. Also, the full image size is supported and is the default if no image size was specified. A still image of the video (aka thumbnail or poster) can also be returned with the video. To specify the size for the poster, add one or more posterSize parameters to the call. Small, medium, large and full sized images of the video will be returned. To distinguish the video and video link in the response, a type parameter is added and is set to "poster".

Parameter Name	Description
secure	Set to true to return secure https URLs for media links. Default is true.
imageSize	Returns the requested size.
posterSize	Returns the requested size(s) for poster of the video links: small, medium, large or full.
convertSvg	Return images and algorithms that are originally in svg format as png format.

Image Link Section when imageSize=small is Requested

When imageSize is requested, the image link will look the same as in the above response, but with the addition of imageSize.

"links": [
        {
            "rel": "external",
            "imageSize": "small",
            "href": "http://media.ebsco.healthcare/eis-live/image/authenticated/t_s200/f_auto/v1/EBSCOHealth/CCMS/i508496.png?cld_token__=exp=1589557523~hmac=39e61c4969ae0fc2034b65fa3096d7582ead7a487cd5ff89301e2f873cb2d5f1"
        }
      ]

Video Link Section when posterSize=large is Requested

 "links": [
        {
          "rel": "external",
          "href": "http://media.ebsco.healthcare/eis-live/video/authenticated/v1/EBSCOHealth/CCMS/Dynamed/videos/V123456.mp4"
        },
        {
          "rel": "external",
          "posterSize": "large",
          "type": "poster",
          "href": "http://media.ebsco.healthcare/eis-live/video/authenticated/t_s1000/f_jpg/v1/EBSCOHealth/CCMS/Dynamed/videos/V123456.jpg"
        }
      ]

Error Response Codes

The DynaMed search for articles endpoint can return one of the error response codes.