Browse our guides and interact with our API reference for more information about MEDSAPI DynaMed. Try MEDSAPI DynaMed and learn about core concepts.





Search (using GET) Code Samples (Deprecated)

Use the code samples below as examples to create an application in your desired language.  The following code samples use the GET /search endpoint which allows you to execute a search request.  The GET is deprecated in favor of the POST.  Get started and begin to understand the endpoint by following the examples below in the language of your choice. 


# Search:

curl -X GET 
  -H "accept: application/json"
  -H "authorization: Bearer TOKEN"
  -H "Content-Type: application/json"
// Search:

// Construct the client
OkHttpClient client = new OkHttpClient();

// Create the URL
HttpUrl url = new HttpUrl.Builder()
    .addQueryParameter("query", "heart")
    .addQueryParameter("filterType", "id")
    .addQueryParameter("filter", "condition")
    .addQueryParameter("filter", "Image")
    .addQueryParameter("secure", "true")
    .addQueryParameter("posterSize", "small")

// Build the request
Request request = new Request.Builder()
    .addHeader("Accept", "application/json")
    .addHeader("Authorization", "Bearer TOKEN")
    .addHeader("Content-Type", "application/json")

// Send the request
Response response = client.newCall(request).execute();
// Search: 

const host = "";
const path = "/medsapi-dynamed/v1/search";
const queryParams = {
    query: "heart",
    filterType: "id",
    filter: "condition",
    secure: true,
    posterSize: "small"

// Create the Request
const url = host + path;

const settings = {
    async: true,
    crossDomain: true,
    url: url,
    method: "GET",
    headers: {
        Accept: "application/json",
        Authorization: "Bearer TOKEN",
        Content-Type: "application/json"
    data: queryParams

// Send the Request
$.ajax(settings).done(function (response) {
# Search:

# Form the URL 
urlstr = File.join('https://', '', 'medsapi-dynamed/v1/search')
uri = URI.parse(urlstr)
params = { :query => "heart", :filterType => "id", :filter=> "condition", filter=> "Image", secure => "true", posterSize => "small"}

# Add params to URI
uri.query = URI.encode_www_form( params )

# Create the HTTP object
http =, uri.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

# Create the request
request =
request["Accept"] = "application/json"
request["Authorization"] = "Bearer TOKEN"
request["Content-Type"] = "application/json"

# Send the request
response = http.request(request)
# Search Suggestions:

# Form the URL
url = ''.join(['/medsapi-dynamed/v1','/search'])
queryParams = {
   'query': 'heart',
   'filterType': 'id',
   'filter': 'condition',
   'filter': 'Image',
   'secure': 'true',
   'posterSize': 'small'

# Create Connection Instance
conn = http.client.HTTPSConnection("")

# Create the Request Headers
headers = {
    'Authorization': "Bearer TOKEN",
    'Accept': "application/json",
    'Cache-Control': "no-cache"

# Send Request  
conn.request("GET", url, queryParams, headers)