Skip to main content
GET
/
codes
Search MedDRA codes
curl --request GET \
  --url https://api.meddra.co/codes
{
  "version": "28.1",
  "results": [
    {
      "code": "10029505",
      "term": "Dizziness",
      "level": "SOC",
      "status": "current",
      "isPrimary": true,
      "primarySocCode": "10029205",
      "socAbbreviation": "NSD",
      "changeType": "added"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 50,
    "total": 245,
    "next": "?page=2&limit=50",
    "previous": "?page=1&limit=50"
  }
}
Combine the q, changeType, soc, hlgt, hlt, and llt parameters to focus on a precise slice of the terminology. Pair with page and limit to build responsive browsers that show hierarchy context inline.

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"

Query Parameters

​
version
string

Override the MedDRA release for this request.

Example:

"28.0"

​
q
string

Free-text search term (supports prefix and fuzzy matching).

Minimum string length: 1
​
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"

​
level
enum<string>

MedDRA hierarchy level.

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

Filter results by change category when comparing releases. Category describing how a concept changed between releases.

Available options:
added,
updated,
retired
​
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

Search results with pagination metadata.

​
version
string
required
Example:

"28.1"

​
results
object[]
required
​
meta
object
required