Application Considerations

The documentation on this site covers all supported functionality of the MedsAPI suite of APIs. Any fields or parameters not represented by the documentation are unsupported and subject to change. Additional optional query parameters and fields in the response could be added in the future as a non breaking change. Any other change that could break the contract would be considered in a future version.

For DynaMed and DynaMedex there are some version 1 and version 2 APIs. For any API that returns an article or an article link, you should use version 2 of the API. This is because version 2 contains more updated article content with additional fields and possibly some fields which may not be backward compatible. If an API only has a version1 then it is fine to use that as it does not return article content or links.

If your application sends requests faster than the service allows, you may receive a 429 “Too Many Requests” response. The threshold is intentionally set quite high, so most applications will never encounter it. If it is exceeded, simply pausing briefly and retrying the request will allow things to continue smoothly.