# MedDRA API

**Canonical:** https://apis.io/apis/meddra/meddra-api/  
**Provider:** Meddra — https://apis.io/providers/meddra/  
**Base URL:** https://mapisbx.meddra.org  
**Documentation:** https://www.meddra.org/meddra-apis

MedDRA API is published by [Meddra](https://apis.io/providers/meddra/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Medical Terminology, Pharmacovigilance, Adverse Events, Search, and Hierarchy. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and 1 JSON Schema.

The MedDRA API published by the MSSO — term and SMQ search, term/SMQ detail, hierarchy navigation and analysis, parent/child type lookup, term history, SMQ analysis, data-file download, search export, language and release listings, version and data-impact reports, subscription validation, and an unauthenticated status check. Sixteen operations in the non-GxP "Production" (formerly Sandbox) environment; four of them (Details, Search, Status, Type) are also offered in the GxP-assessed environment. Every operation but Status requires an OAuth 2.0 bearer token issued by the MedDRA identity provider against a MedDRA subscription.

## Operations (16)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/di` | Returns Data Impacted between Versions. |
| POST | `/api/detail` | Returns Details object for Term Code. |
| GET | `/api/downld/{lang}/{ver}/{file}/{format}` | Returns Term objects for Downloads and Files. |
| POST | `/api/export` | Returns Term objects for Search Export. |
| POST | `/api/gt` | Returns Lists of Top Level Terms i.e. SOC/SMQ |
| POST | `/api/hier` | Returns A Hierarchy Anaylsis of inputted terms. |
| GET | `/api/hist/{code}/{htype}/{lang}/{rsview}` | Returns History object for Term Code. |
| GET | `/api/hist/{term}/{lang}/{rsview}` | Returns Term objects for History look up. |
| GET | `/api/lang/{langt}` | Returns list of Available Languages. |
| GET | `/api/rel` | Returns list of Available Releases. |
| POST | `/api/search` | Returns Search Results for a specific input. |
| POST | `/api/smqa` | Returns SMQ Analysis specific input. |
| GET | `/api/status` | Returns Status of API. |
| POST | `/api/sv` | Returns Validation of input list. |
| POST | `/api/type` | Returns Parents/Children/MedDRA hiearchy for term requested. |
| POST | `/api/vr` | Returns Data Impacted between Versions. |

## Machine-readable artifacts (12)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/meddra/refs/heads/main/openapi/meddra-api-openapi.yml
- **OpenAPI** — https://mapisbx.meddra.org/swagger/v1/swagger.json
- **Documentation** — https://www.meddra.org/meddra-apis
- **APIReference** — https://mapisbx.meddra.org/index.html
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/meddra/refs/heads/main/authentication/meddra-authentication.yml
- **OAuthScopes** — https://raw.githubusercontent.com/api-evangelist/meddra/refs/heads/main/scopes/meddra-scopes.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/meddra/refs/heads/main/errors/meddra-problem-types.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/meddra/refs/heads/main/overlays/meddra-api-overlay.yaml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/meddra/refs/heads/main/data-model/meddra-data-model.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/meddra/refs/heads/main/json-schema/meddra-term-schema.json
- **JSONLDContext** — https://raw.githubusercontent.com/api-evangelist/meddra/refs/heads/main/json-ld/meddra-context.jsonld
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/meddra/refs/heads/main/apis.yml

## Tags

Medical Terminology, Pharmacovigilance, Adverse Events, Search, Hierarchy

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/meddra/meddra-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/meddra/.