Understanding the API Results

For search queries (such as: https://api.fda.gov/drug/label.json?search=effective_date:[20040101+TO+20081231]&limit=1), the results section includes matching SPL reports returned by the API.

Each SPL report consists of these major sections:

  • Standard SPL fields, including unique identifiers.
  • Product-specific fields, the order and contents of which are unique to each product.
  • An openfda section: An annotation with additional product identifiers, such as UPC and brand name, of the drug products listed in the labeling.

For count queries (such as: https://api.fda.gov/drug/label.json?count=openfda.product_type.exact), the results section will look something like the following:

{
  "meta": {
    "disclaimer": "Do not rely on openFDA to make decisions regarding medical care. While we make every effort to ensure that data is accurate, you should assume all results are unvalidated. We may limit or otherwise restrict your access to the API in line with our Terms of Service.",
    "terms": "https://open.fda.gov/terms/",
    "license": "https://open.fda.gov/license/",
    "last_updated": "2017-12-02"
  },
  "results": [
    {
      "term": "HUMAN OTC DRUG",
      "count": 55849
    },
    {
      "term": "HUMAN PRESCRIPTION DRUG",
      "count": 33489
    }
  ]
}