Skip to main content
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": {
    "items": [
      {
        "name": "Lightheadedness",
        "sourceCode": "10025035",
        "isPrimary": false
      }
    ],
    "_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>

Category describing how a concept changed between releases.

Available options:
added,
updated,
retired
​
version
string
Example:

"28.1"

​
synonyms
object
​
parents
object[]
​
children
object[]
​
change
object
⌘I