Skip to main content
GET /codes/{code} is the primary endpoint for drilling into a MedDRA concept. It returns the concept metadata, hierarchy context, and change history you need for UI detail views or downstream processing.

​
Core properties

The response includes:
  • code, term, level, and status – the canonical identifiers and the current lifecycle state (for example, Current or Non-current).
  • isPrimary and primarySocCode – flags that help you highlight primary Preferred Terms within a System Organ Class.
  • synonyms – Lowest Level Terms linked to the Preferred Term, returned with pagination via meta.
curl https://api.meddra.co/codes/10011906

{
	"code": "10011906",
	"term": "Anaphylactic shock",
	"level": "PT",
	"status": "CURRENT",
	"isPrimary": true,
	"primarySocCode": "10029205",
	"synonyms": {
		"results": [{ "name": "Anaphylactic reaction NOS", "isPrimary": false }],
		"meta": {
			"page": 1,
			"limit": 25,
			"total": 63,
			"next": "?synonymsPage=2&synonymsLimit=25",
			"previous": null
		}
	}
}
Use synonymsPage and synonymsLimit to page through longer synonym lists.

​
Hierarchy context

The payload includes parents and children arrays, each item describing the relationship type (for example, SOC_TO_PT, HLT_TO_PT, PT_TO_LLT). This makes it easy to render tree views without issuing extra requests. If you only need the immediate parents, you can filter the array client-side.

​
Change insights

If the concept was added, updated, or retired in the current MedDRA release, the change object provides:
  • changeType: ADDED, UPDATED, or RETIRED
  • details: optional descriptive text from the source release
  • previousTerm: the prior term name, when applicable
For comparisons across releases, use GET /codes/{code}/changes to compare two versions directly.

​
Best practices

  • Cache responses when building UI detail views; individual codes change infrequently between releases.
  • Pair changeType flags with styling to highlight newly added or retired concepts.
  • Combine hierarchy data with the /versions/{toVersionId}/changes endpoint for release-level dashboards.