Application Development Support: Web Services: RESTful Resources

"/spls"

Returns a list of all SPLs. For more information about SPLs, please visit the FDA documentation for Structured Product Labels.
API Version: 2

Query Parameters

Filters

  • application_number - New Drug Application (NDA) number. This parameter is optional. See the documentation for resource /applicationnumbers for more information.
  • boxed_warning - Whether or not a drug contains a boxed warning. This parameter is optional. Acceptable values are listed below.
    • true - Contains a boxed warning.
    • false - Does not contain a boxed warning.
  • dea_schedule_code - Code representing a Drug Enforcement Administration Schedule for drugs. This parameter is optional. See the FDA documentation for DEA Schedules for more information. Acceptable values are listed below.
    • none - Not Scheduled.
    • C48672 - CI.
    • C48675 - CII.
    • C48676 - CIII.
    • C48677 - CIV.
    • C48679 - CV.
  • doctype - FDA's Logical Observation Identifiers Names and Codes system. Determines the type of document or content of a label. This parameter is optional. See the FDA documentation for Document and Labeling Content Types for more information.
  • drug_class_code - Code representing a pharmacologic drug class. This parameter is optional. See the documentation for resource /drugclasses for more information.
  • drug_class_coding_system - Used with drug_class_code to specify the coding system of the drug class code. This parameter is optional. Acceptable values are listed below.
    • 2.16.840.1.113883.3.26.1.5 - National Drug File Reference Terminology. (Default value)
  • drug_name - Generic or brand name. This parameter is optional. See the documentation for resource /drugnames for more information.
  • name_type - Used with drug_name to specify whether the given name is a generic name or brand name. This parameter is optional. Acceptable values are listed below.
    • g or generic - Generic name.
    • b or brand - Brand name.
    • both - Either generic or brand name. (Default value)
  • labeler - Name of labeler for the drug. This parameter is optional.
  • manufacturer - Name of manufacturer for the drug. This parameter is optional.
  • marketing_category_code - FDA's Marketing Categories for types of drugs. This parameter is optional. See the FDA documentation for Marketing Category for more information.
  • ndc - National Drug Code (NDC). This parameter is optional. See the documentation for resource /ndcs for more information.
  • published_date - The date that the drug was published on DailyMed. This parameter is optional. The accepted date format is YYYY-MM-DD (ex. 2015-09-10)
  • published_date_comparison - Used with published_date to specify the type of comparison used with the date. This parameter is optional. Acceptable values are listed below.
    • lt - Drugs that have a published date Less Than the published_date parameter.
    • lte - Drugs that have a published date Less Than or Equal To the published_date parameter.
    • gt - Drugs that have a published date Greater Than the published_date parameter.
    • gte - Drugs that have a published date Greater Than or Equal To the published_date parameter.
    • eq - Drugs that have a published date Equal To the published_date parameter (Default value)
  • rxcui - RxNorm Concept Unique Identifier (RXCUI) code. This parameter is optional. See the documentation for resource /rxcuis for more information.
  • setid - Set ID of a label. This parameter is optional.
  • unii_code - Unique Ingredient Identifier (UNII) code. This parameter is optional. See the documentation for resource /uniis for more information.

Output Controls

  • pagesize - The number of records returned per page. This parameter is optional (Default 100, Maximum 100).
  • page - The page returned. This parameter is optional (Default 1).

Return Formats

RETURN FORMATS EXAMPLES

  • XML: https://dailymed.nlm.nih.gov/dailymed/services/v2/spls.xml?rxcui=312962&pagesize=5&page=2

    Returns

    <?xml version="1.0" encoding="UTF-8" ?>
    <spls>
    	<metadata>
    		<total_elements>26</total_elements>
    		<elements_per_page>5</elements_per_page>
    		<total_pages>6</total_pages>
    		<current_page>2</current_page>
    		<current_url>https://dailymed.nlm.nih.gov/dailymed/services/v2/spls.xml?rxcui=312962&pagesize=5&page=2</current_url>
    		<previous_page>1</previous_page>
    		<previous_page_url>https://dailymed.nlm.nih.gov/dailymed/services/v2/spls.xml?rxcui=312962&pagesize=5&page=1</previous_page_url>
    		<next_page>3</next_page>
    		<next_page_url>https://dailymed.nlm.nih.gov/dailymed/services/v2/spls.xml?rxcui=312962&pagesize=5&page=3</next_page_url>
    	</metadata>
    	<spl>
    		<setid>fdbfe194-b845-42c5-bb87-a48118bc72e7</setid>
    		<spl_version>25</spl_version>
    		<title>ZOCOR (SIMVASTATIN) TABLET, FILM COATED [MERCK SHARP & DOHME CORP.]</title>
    		<published_date>Nov 01, 2013</published_date>
    	</spl>
    	<spl>
    		<setid>7d46690d-090d-4d8b-af63-e57c48fc86b5</setid>
    		<spl_version>1</spl_version>
    		<title>SIMVASTATIN TABLET, FILM COATED [CARDINAL HEALTH]</title>
    		<published_date>Sep 26, 2013</published_date>
    	</spl>
    	<spl>
    		<setid>9a3d815e-ab40-4c1c-a065-281dac6685a6</setid>
    		<spl_version>1</spl_version>
    		<title>SIMVASTATIN TABLET, FILM COATED [GEN-SOURCE RX]</title>
    		<published_date>May 20, 2013</published_date>
    	</spl>
    	<spl>
    		<setid>5c1c694c-4b08-469e-b538-08e69df06146</setid>
    		<spl_version>90384</spl_version>
    		<title>SIMVASTATIN TABLET [MICRO LABS LIMITED]</title>
    		<published_date>Apr 30, 2013</published_date>
    	</spl>
    	<spl>
    		<setid>881eb80b-712e-4aa2-bd23-290a3e5db6cd</setid>
    		<spl_version>4</spl_version>
    		<title>SIMVASTATIN TABLET, FILM COATED [CADILA HEALTHCARE LIMITED]</title>
    		<published_date>Apr 08, 2013</published_date>
    	</spl>
    </spls>
    													
    Close
  • JSON: https://dailymed.nlm.nih.gov/dailymed/services/v2/spls.json?rxcui=312962&pagesize=5&page=2

    Returns

    {
    	"metadata": {
    		"elements_per_page": "5",
    		"next_page_url": "https:\/\/dailymed.nlm.nih.gov\/dailymed\/services\/v2\/spls.json?rxcui=312962&pagesize=5&page=3",
    		"total_pages": "6",
    		"total_elements": "26",
    		"current_url": "https:\/\/dailymed.nlm.nih.gov\/dailymed\/services\/v2\/spls.json?rxcui=312962&pagesize=5&page=2",
    		"next_page": "3",
    		"previous_page": "1",
    		"previous_page_url": "https:\/\/dailymed.nlm.nih.gov\/dailymed\/services\/v2\/spls.json?rxcui=312962&pagesize=5&page=1",
    		"current_page": "2"
    	},
    	"data": [{
    		"spl_version": "25",
    		"published_date": "Nov 01, 2013",
    		"setid": "fdbfe194-b845-42c5-bb87-a48118bc72e7",
    		"title": "ZOCOR (SIMVASTATIN) TABLET, FILM COATED [MERCK SHARP & DOHME CORP.]"
    	}, {
    		"spl_version": "1",
    		"published_date": "Sep 26, 2013",
    		"setid": "7d46690d-090d-4d8b-af63-e57c48fc86b5",
    		"title": "SIMVASTATIN TABLET, FILM COATED [CARDINAL HEALTH]"
    	}, {
    		"spl_version": "1",
    		"published_date": "May 20, 2013",
    		"setid": "9a3d815e-ab40-4c1c-a065-281dac6685a6",
    		"title": "SIMVASTATIN TABLET, FILM COATED [GEN-SOURCE RX]"
    	}, {
    		"spl_version": "90384",
    		"published_date": "Apr 30, 2013",
    		"setid": "5c1c694c-4b08-469e-b538-08e69df06146",
    		"title": "SIMVASTATIN TABLET [MICRO LABS LIMITED]"
    	}, {
    		"spl_version": "4",
    		"published_date": "Apr 08, 2013",
    		"setid": "881eb80b-712e-4aa2-bd23-290a3e5db6cd",
    		"title": "SIMVASTATIN TABLET, FILM COATED [CADILA HEALTHCARE LIMITED]"
    	}]
    }
    													
    Close

RETURN TO WEB SERVICES