Meddra

Meddra Type API

The Type API from Meddra — 1 operation(s) for type.

GitHub OpenAPI

Operations 1

POST /api/type Returns Parents/Children/MedDRA hiearchy for term requested #

Documentation

📖
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

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/meddra/refs/heads/main/openapi/meddra-type-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/meddra/refs/heads/main/json-schema/meddra-term-schema.json

Other Resources

🔗
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
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/meddra/refs/heads/main/data-model/meddra-data-model.yml
🔗
JSONLDContext
https://raw.githubusercontent.com/api-evangelist/meddra/refs/heads/main/json-ld/meddra-context.jsonld

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/meddra:meddra-type-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

meddra-type-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: MedDRA API EUS SBX Type API
  description: Web API to access MedDRA Data
  contact:
    name: Web Admin
    url: http://www.meddra.org/
    email: wadmin@meddra.org
  version: '1'
security:
- oauth2:
  - meddraapi
tags:
- name: Type
paths:
  /api/type:
    post:
      tags:
      - Type
      summary: Returns Parents/Children/MedDRA hiearchy for term requested
      requestBody:
        content:
          application/json-patch+json:
            schema:
              $ref: '#/components/schemas/MedTypeDTO'
          application/json:
            schema:
              $ref: '#/components/schemas/MedTypeDTO'
          text/json:
            schema:
              $ref: '#/components/schemas/MedTypeDTO'
          application/*+json:
            schema:
              $ref: '#/components/schemas/MedTypeDTO'
      responses:
        '200':
          description: Success
        200 rtype=M bview=SOC:
          description: List of mdhierDTO
        200 rtype=M bview=SMQ:
          description: List of smqtDTO
        200 rtype=C type=SOC:
          description: List of hlgtDTO
        200 rtype=C type=HLGT:
          description: List of hltDTO
        200 rtype=C type=HLT:
          description: List of ptDTO
        200 rtype=C type=PT:
          description: List of lltDTO
        200 rtype=C type=LLT lang=Japanese:
          description: List of synDTO
        200 rtype=C type=SMQ:
          description: smqDTO
        200 rtype=CF type=SOC:
          description: List of hlgtDTO
        200 rtype=CF type=HLGT:
          description: List of hltDTO
        200 rtype=CF type=HLT:
          description: List of ptDTO
        200 rtype=CF type=PT:
          description: List of lltDTO
        200 rtype=CF type=SMQ:
          description: List of smqftDTO
        200 rtype=P type=SYN lang=Japanese:
          description: List of lltDTO
        200 rtype=P type=LLT bview=SOC:
          description: List of ptDTO
        200 rtype=P type=PT bview=SOC:
          description: List of hltDTO
        200 rtype=P type=HLT:
          description: List of hlgtDTO
        200 rtype=P type=HLGT:
          description: List of socDTO
        200 rtype=P type=LLT bview=SMQ:
          description: List of ptDTO
        200 rtype=P type=PT bview=SMQ:
          description: List of smqDTO
        200 rtype=P type=SMQ:
          description: List of smqDTO
        400 v1:
          description: Failed Model Validation
        400 v2:
          description: Failed Validation
        400 v3:
          description: Insufficient Authorization
        400 v4:
          description: Internal Server Exception
        400 v5:
          description: Language/Version Does Not exist
        400 v6:
          description: Invalid Input
        '401':
          description: Unauthorized Access
        '415':
          description: Unsupported Media Type
        '429':
          description: The throttling limit on this API has been exceeded.  Please review the MedDRA API documentation on throttling limits.
        '500':
          description: Internal Server Error
      operationId: postApiType
      x-operation-id-source: derived
components:
  schemas:
    MedTypeDTO:
      required:
      - addlangs
      - bview
      - code
      - hlgtcode
      - hltcode
      - kana
      - lang
      - lltcode
      - pcode
      - ptcode
      - rsview
      - rtype
      - separator
      - smqcode
      - soccode
      - syncode
      - type
      - ver
      type: object
      properties:
        bview:
          type: string
          description: '[Required]

            Acceptible Browser Views

            SOC/SMQ'
        rsview:
          type: string
          description: '[Required]

            Acceptible Release views

            release'
        code:
          type: integer
          description: '[Required] for MedDRA Term or SMQ Code'
          format: int32
        pcode:
          type: integer
          description: Parent Term Code
          format: int32
        syncode:
          type: integer
          description: 'Used in Type API where return type = M.

            Synonym Code.

            Japanese only.'
          format: int32
        lltcode:
          type: integer
          description: 'Used in Type API where return type = M.

            LLT Code.'
          format: int32
        ptcode:
          type: integer
          description: 'Used in Type API where return type = M.

            PT Code.'
          format: int32
        hltcode:
          type: integer
          description: 'Used in Type API where return type = M.

            HLT Code.'
          format: int32
        hlgtcode:
          type: integer
          description: 'Used in Type API where return type = M.

            HLGT Code.'
          format: int32
        soccode:
          type: integer
          description: 'Used in Type API where return type = M.

            SOC Code.'
          format: int32
        smqcode:
          type: integer
          description: 'Used in Type API where return type = M or SE.

            SMQ Code.'
          format: int32
        type:
          type: string
          description: '[Required] MedDRA type. See programmers guide for acceptible values.

            SOC/SMQ/HLGT/HLT/PT/LLT/SYN/MDHEIR'
        addlangs:
          type: array
          items:
            type: string
          description: 'Array for Additional  translations to return.

            Refer to the Language API for valid inputs'
        rtype:
          type: string
          description: '[Required] MedDRA type. See programmers guide for acceptible values.'
        lang:
          type: string
          description: '[Required]

            Primary Language to Return.'
        ver:
          type: number
          description: '[Required]

            Release Version to use.

            Refer to Release API for valid Language/Version Combinations.'
          format: double
        kana:
          type: boolean
          description: Return of Japanese Kana Translation.
        separator:
          type: integer
          description: "Separator to use if selecting Additional Languages.\n0 = \" \" \n1 = \"\\n\"\n2 = \" | \""
          format: int32
      additionalProperties: false
      description: Model for Requesting Parents/Children/mdheir for Terms.
  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        implicit:
          authorizationUrl: https://mid.meddra.org/connect/authorize
          scopes:
            meddraapi: Meddra API - full access