> ## Documentation Index
> Fetch the complete documentation index at: https://ekacare-quickstart-cleanup.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Generic (pharmacology) Information

## Why Use This API

Access generic information from India's National Formulary through a simple REST API. Instead of manually compiling medication databases or scraping multiple sources, get structured generic data that's already standardized and ready to use in your application.

This information has been extracted from guidelines published by the National Formulary of India from the Ministry of Health & Welfare (Government of India) - [Link](https://qps.nhsrcindia.org/sites/default/files/2022-01/National%20Formulary%20of%20India%20%28NFI%29%2C%202011.pdf)

The details have been extracted through a vision LLM and every generic has been validated by a team of clinicians at eka.care

## What You Get Per Generic

Each response includes comprehensive information about the medication:

### Clinical Information

* **What it treats** (`indications`) - Medical conditions and symptoms
* **How much to take** (`dose`) - Dosing instructions for adults and children
* **Drug interactions** (`precautions_appendix`) - Contraindications and safety warnings
* **Side effects** (`adverse_effects`, `contraindications`) - Known adverse reactions and warnings
* **Pregnancy safety** (`pregnancy_category`) - Safety classification for pregnant patients

### Drug Details

* **Generic name** (`generic_name`) - Standard medication name
* **Components** (`components`, `is_compound`) - Active ingredients and compound status
* **Category** (`generic_category`) - Therapeutic classification
* **Available forms** (`availability`) - Tablets, capsules, injections, etc.
* **Storage** (`storage`) - Temperature and storage requirements
* **Schedule** (`schedule`) - Regulatory classification
* **Notes** (`note`) - Additional clinical guidance

## Search Capabilities

The search supports:

* **Single generic searches**: Find specific medications by generic name
* **Compound generic searches**: Search for combination generics using separators like "+", ",", "and"
* **Category filtering**: Filter by generic categories
* **Exact matching**: Option for precise matches only
* **Relevance threshold**: Adjustable filtering for result quality


## OpenAPI

````yaml get /eka-mcp/pharmacology/v1/search
openapi: 3.1.0
info:
  title: MCP Eka Assist API
  description: Eka Assist documentation
  version: 1.0.0
  contact:
    name: Nikhil
    url: https://eka.care/
    email: nikhil.kasukurthi@eka.care
servers:
  - url: https://api.dev.eka.care
    description: Staging Server
  - url: https://api.eka.care
    description: Prod Server
security:
  - BearerAuth: []
tags:
  - name: protocols
  - name: medications
  - name: pharmacology
  - name: snomed
paths:
  /eka-mcp/pharmacology/v1/search:
    get:
      tags:
        - pharmacology
      summary: Get Generic (pharmacology) Information
      parameters:
        - name: query
          in: query
          schema:
            anyOf:
              - type: string
              - type: 'null'
            default: null
            description: >-
              Text to search for across all fields. Can be a single drug name
              (e.g., 'Rifampicin') or compound drugs (e.g., 'Rifampicin +
              Isoniazid')
            title: Query
          required: false
          description: >-
            Text to search for across all fields. Can be a single drug name
            (e.g., 'Rifampicin') or compound drugs (e.g., 'Rifampicin +
            Isoniazid')
        - name: category
          in: query
          schema:
            anyOf:
              - type: string
              - type: 'null'
            default: null
            description: Filter by category (e.g., 'Antibiotics', 'Analgesics')
            title: Category
          required: false
          description: Filter by category (e.g., 'Antibiotics', 'Analgesics')
        - name: limit
          in: query
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            default: 10
            description: Maximum number of results to return
            title: Limit
          required: false
          description: Maximum number of results to return
        - name: exact_match
          in: query
          schema:
            anyOf:
              - type: boolean
              - type: 'null'
            default: false
            description: If true, only return exact matches for the query
            title: Exact Match
          required: false
          description: If true, only return exact matches for the query
        - name: relevance_threshold
          in: query
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            default: 100
            description: >-
              Minimum relevance score for results (higher = more strict
              filtering)
            title: Relevance Threshold
          required: false
          description: Minimum relevance score for results (higher = more strict filtering)
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PharmacologySearchResponse.a9993e3'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericErr.82b01e4'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericErr.82b01e4'
components:
  schemas:
    PharmacologySearchResponse.a9993e3:
      properties:
        results:
          items:
            $ref: '#/components/schemas/PharmacologyEntry.a9993e3'
          type: array
          title: Results
        search_info:
          additionalProperties: true
          type: object
          title: Search Info
          default: {}
      required:
        - results
      title: PharmacologySearchResponse
      type: object
    GenericErr.82b01e4:
      properties:
        error:
          title: Error
          type: string
      required:
        - error
      title: GenericErr
      type: object
    PharmacologyEntry.a9993e3:
      properties:
        generic_name:
          type: string
          title: Generic Name
          description: The generic name of the drug
        components:
          items:
            type: string
          type: array
          title: Components
          description: Array of active components
        is_compound:
          type: boolean
          title: Is Compound
          description: Boolean indicating if it's a compound drug
        page_number:
          anyOf:
            - type: integer
            - type: 'null'
          title: Page Number
          description: NFI page number reference
        reference_page_number:
          anyOf:
            - type: integer
            - type: 'null'
          title: Reference Page Number
          description: Reference page number if applicable
        has_references:
          anyOf:
            - type: integer
            - type: 'null'
          title: Has References
          description: Indicates if drug has references
        is_a_reference:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is A Reference
          description: Indicates if this entry is a reference
        pregnancy_category:
          anyOf:
            - type: string
            - type: 'null'
          title: Pregnancy Category
          description: FDA pregnancy category (A, B, C, D, X)
        indications:
          anyOf:
            - type: string
            - type: 'null'
          title: Indications
          description: Medical conditions the drug treats
        availability:
          anyOf:
            - type: string
            - type: 'null'
          title: Availability
          description: Available formulations and strengths
        dose:
          anyOf:
            - type: string
            - type: 'null'
          title: Dose
          description: Detailed dosing instructions for adults and children
        contraindications:
          anyOf:
            - type: string
            - type: 'null'
          title: Contraindications
          description: Conditions where the drug should not be used
        precautions:
          anyOf:
            - type: string
            - type: 'null'
          title: Precautions
          description: Important safety considerations and monitoring requirements
        precautions_appendix:
          anyOf:
            - type: string
            - type: 'null'
          title: Precautions Appendix
          description: Detailed interaction information organized by appendices
        adverse_effects:
          anyOf:
            - type: string
            - type: 'null'
          title: Adverse Effects
          description: Known side effects and adverse reactions
        storage:
          anyOf:
            - type: string
            - type: 'null'
          title: Storage
          description: Storage requirements
        schedule:
          anyOf:
            - type: string
            - type: 'null'
          title: Schedule
          description: Drug scheduling classification
        note:
          anyOf:
            - type: string
            - type: 'null'
          title: Note
          description: Important clinical notes and warnings
        additional_keys:
          anyOf:
            - type: string
            - type: 'null'
          title: Additional Keys
          description: >-
            Extended clinical information including combination therapy
            protocols
        generic_category:
          anyOf:
            - type: string
            - type: 'null'
          title: Generic Category
          description: Drug classification (e.g., Anti-Infectives, Analgesics)
        comments:
          anyOf:
            - type: string
            - type: 'null'
          title: Comments
          description: Editorial comments and additional notes
      required:
        - generic_name
        - components
        - is_compound
      title: PharmacologyEntry
      type: object
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Enter JWT token

````