Get MedDRA code

curl --request GET \
  --url https://api.meddra.co/codes/{code}

{
  "code": "10029505",
  "term": "Dizziness",
  "level": "SOC",
  "status": "current",
  "isPrimary": true,
  "primarySocCode": "10029205",
  "socAbbreviation": "NSD",
  "changeType": "added",
  "version": "28.1",
  "synonyms": {
    "results": [
      {
        "name": "Lightheadedness",
        "isPrimary": false,
        "sourceCode": "10025035"
      }
    ],
    "meta": {
      "page": 1,
      "limit": 50,
      "total": 245,
      "next": "?page=2&limit=50",
      "previous": "?page=1&limit=50"
    }
  },
  "parents": [
    {
      "code": "10029205",
      "term": "Nervous system disorders",
      "level": "SOC",
      "relationship": "HLT_TO_PT"
    }
  ],
  "children": [
    {
      "code": "10029205",
      "term": "Nervous system disorders",
      "level": "SOC",
      "relationship": "HLT_TO_PT",
      "isPrimarySoc": false
    }
  ],
  "change": {
    "changeType": "added",
    "details": "Preferred term renamed from 'Dizzy spells'.",
    "previousTerm": "Dizzy spells"
  }
}

GET

codes

{code}

Get MedDRA code

curl --request GET \
  --url https://api.meddra.co/codes/{code}

{
  "code": "10029505",
  "term": "Dizziness",
  "level": "SOC",
  "status": "current",
  "isPrimary": true,
  "primarySocCode": "10029205",
  "socAbbreviation": "NSD",
  "changeType": "added",
  "version": "28.1",
  "synonyms": {
    "results": [
      {
        "name": "Lightheadedness",
        "isPrimary": false,
        "sourceCode": "10025035"
      }
    ],
    "meta": {
      "page": 1,
      "limit": 50,
      "total": 245,
      "next": "?page=2&limit=50",
      "previous": "?page=1&limit=50"
    }
  },
  "parents": [
    {
      "code": "10029205",
      "term": "Nervous system disorders",
      "level": "SOC",
      "relationship": "HLT_TO_PT"
    }
  ],
  "children": [
    {
      "code": "10029205",
      "term": "Nervous system disorders",
      "level": "SOC",
      "relationship": "HLT_TO_PT",
      "isPrimarySoc": false
    }
  ],
  "change": {
    "changeType": "added",
    "details": "Preferred term renamed from 'Dizzy spells'.",
    "previousTerm": "Dizzy spells"
  }
}

This route powers code detail pages and tooltips. Include ?version= or the X-MedDRA-Version header to review the concept in a historical release.

Headers

X-API-Version

string

default:1

Override the default API version. Defaults to 1.

Example:

"1"

X-MedDRA-Version

string

Target a specific MedDRA release. Defaults to the latest.

Example:

"28.0"

Path Parameters

code

string

required

MedDRA code identifier.

Example:

"10029505"

Query Parameters

version

string

Override the MedDRA release for this request.

Example:

"28.0"

synonymsPage

integer

Select the synonyms page (defaults to 1).

Required range: x >= 1

Example:

1

synonymsLimit

integer

Number of synonyms to return per page (defaults to 25, max 200).

Required range: 1 <= x <= 200

Example:

25

Response

Detailed information for the requested code.

code

string

required

Example:

"10029505"

term

string

required

Example:

"Dizziness"

level

enum<string>

required

MedDRA hierarchy level.

Available options:

SOC,

HLGT,

HLT,

PT,

LLT

status

string

required

Example:

"current"

isPrimary

boolean

required

Example:

true

primarySocCode

string | null

Example:

"10029205"

socAbbreviation

string | null

Example:

"NSD"

changeType

enum<string> | null

Category describing how a concept changed between releases.

Available options:

added,

updated,

retired

version

string

Example:

"28.1"

synonyms

object

Show child attributes

synonyms.results

object[]

required

Show child attributes

synonyms.results.name

string

required

Example:

"Lightheadedness"

synonyms.results.isPrimary

boolean

required

Example:

false

synonyms.results.sourceCode

string | null

Example:

"10025035"

synonyms.meta

object

required

Show child attributes

synonyms.meta.page

integer

required

Example:

1

synonyms.meta.limit

integer

required

Example:

50

synonyms.meta.total

integer

required

Example:

245

synonyms.meta.next

string | null

required

Example:

"?page=2&limit=50"

synonyms.meta.previous

string | null

required

Example:

"?page=1&limit=50"

parents

object[]

Show child attributes

parents.code

string

required

Example:

"10029205"

parents.term

string

required

Example:

"Nervous system disorders"

parents.level

enum<string>

required

MedDRA hierarchy level.

Available options:

SOC,

HLGT,

HLT,

PT,

LLT

parents.relationship

string

required

Example:

"HLT_TO_PT"

children

object[]

Show child attributes

children.code

string

required

Example:

"10029205"

children.term

string

required

Example:

"Nervous system disorders"

children.level

enum<string>

required

MedDRA hierarchy level.

Available options:

SOC,

HLGT,

HLT,

PT,

LLT

children.relationship

string

required

Example:

"HLT_TO_PT"

children.isPrimarySoc

boolean

required

Example:

false

change

object

Show child attributes

change.changeType

enum<string>

required

Category describing how a concept changed between releases.

Available options:

added,

updated,

retired

change.details

string | null

Example:

"Preferred term renamed from 'Dizzy spells'."

change.previousTerm

string | null

Example:

"Dizzy spells"

Search MedDRA codes Get MedDRA code changes

⌘I

Overview

Versions

Codes

Adverse Events

Product Labels

Get MedDRA code

Headers

Path Parameters

Query Parameters

Response