Skip to main content
GET
/
versions
/
{toVersionId}
/
changes
Get MedDRA version changelog
curl --request GET \
  --url https://api.meddra.co/versions/{toVersionId}/changes
{
  "versions": {
    "from": "28.0",
    "to": "28.1"
  },
  "items": [
    {
      "code": "10029505",
      "level": "SOC",
      "changeType": "added",
      "details": "<string>",
      "previousTerm": "Dizziness aggravated",
      "metadata": {}
    }
  ],
  "changes": {
    "added": 124,
    "updated": 57,
    "retired": 6
  },
  "_meta": {
    "page": 1,
    "limit": 50,
    "total": 245,
    "next": "?page=2&limit=50",
    "previous": "?page=1&limit=50"
  }
}
Supply a fromVersionId query parameter when you need to benchmark one release against another; otherwise the API falls back to the previous published release. Use hierarchy filters and pagination to focus the response on the slice of terminology that matters.

Headers

​
X-API-Version
string
default:1

Override the default API version. Defaults to 1.

Example:

"1"

Path Parameters

​
toVersionId
string
required

Identifier of the MedDRA release (for example 28.1).

Query Parameters

​
fromVersionId
string

MedDRA release used as the baseline for the change comparison. Defaults to the previous published release when omitted.

Example:

"28.0"

​
level
enum<string>

Limit results to a specific MedDRA hierarchy level.

Available options:
SOC,
HLGT,
HLT,
PT,
LLT
​
changeType
enum<string>

Filter results by change category when comparing releases.

Available options:
added,
updated,
retired
​
soc
string

Filter results by System Organ Class code.

Example:

"10029205"

​
hlgt
string

Filter results by High Level Group Term code.

Example:

"10017394"

​
hlt
string

Filter results by High Level Term code.

Example:

"10027320"

​
llt
string

Filter results by Lowest Level Term code.

Example:

"10027325"

​
page
integer
default:1

Page number (1-indexed).

Required range: x >= 1
​
limit
integer
default:50

Number of results per page.

Required range: 1 <= x <= 200

Response

Change summary between the selected releases.

​
versions
object
required

Pair of MedDRA releases used for a change comparison.

​
items
object[]
required
​
changes
object
required

Aggregate counts of terminology changes.

​
_meta
object
required
⌘I