# getLabelHistory

**Identifier:** `dailymed_getLabelHistory`

**Provider:** [DailyMed](https://kirha.com/providers/dailymed.md)

Get the full version history of one DailyMed label (every published SPL version with its date), the label's Recent Major Changes section (which sections changed and when, PLR labels only), its FDA application numbers and product NDCs. Answers 'when was this label last updated' and 'how often does it change'; use compareLabelVersions to see the actual text that changed.

## Run it with the CLI

```bash
kirha tools run dailymed_getLabelHistory \
  --input '{
    "setId": "<setId>"
  }'
```

`--input` takes a JSON object that matches the input schema. Pass `--input -` to read it from stdin.

## Call it over HTTP

```bash
curl https://api.kirha.com/tools/v1/execute \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: **********' \
  --data '{
  "tool_name": "dailymed_getLabelHistory",
  "input": {
    "setId": "<setId>"
  }
}'
```

Replace the stars with an API key from https://app.kirha.com/api-keys.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "setId": {
      "description": "SPL set ID from searchLabels or openfda-mcp searchDrugLabels",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "type": "string"
    }
  },
  "required": [
    "setId"
  ],
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "applicationNumbers": {
      "description": "Join key to openfda-mcp (drug approvals, Orange Book)",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "context": {
      "type": "string"
    },
    "currentPublishedDate": {
      "type": "string"
    },
    "currentVersion": {
      "type": "number"
    },
    "effectiveDate": {
      "description": "Effective date stated in the current SPL document",
      "type": "string"
    },
    "productNdcs": {
      "description": "labeler-product NDCs; join key to openfda-mcp searchNdcDirectory",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "recentMajorChanges": {
      "description": "Lines of the Recent Major Changes section: changed section and month/year",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "setId": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "versionCount": {
      "type": "number"
    },
    "versions": {
      "description": "Newest first",
      "items": {
        "additionalProperties": false,
        "properties": {
          "publishedDate": {
            "type": "string"
          },
          "version": {
            "type": "number"
          }
        },
        "required": [
          "version",
          "publishedDate"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "context",
    "setId",
    "currentVersion",
    "currentPublishedDate",
    "versionCount",
    "versions",
    "applicationNumbers",
    "productNdcs"
  ],
  "type": "object"
}
```

## Related tools

Other DailyMed tools that this tool refers to, or that refer to it.

- [`searchLabels`](https://kirha.com/providers/dailymed/searchLabels.md)
- [`compareLabelVersions`](https://kirha.com/providers/dailymed/compareLabelVersions.md)

-----

[All DailyMed tools](https://kirha.com/providers/dailymed.md) · [< Back to tools list](https://kirha.com/tools.md)