Optum Merck Manual API

openapi: 3.2.0
info:
  title: Core Service Merck Manual API
  description: Code Search Service provides the APIs for searching codes related information.
  contact:
    name: Ken Kracker
    email: ken.kracker@optum.com
  version: v1.0
servers:
- url: /v1/codesearchms
tags:
- name: Merck Manual API
paths:
  /api/coding/code/merck-manual/{code}:
    get:
      tags:
      - Merck Manual API
      summary: Fetches Merck Manuals for given code
      operationId: getMerckManuals
      parameters:
      - name: code
        in: path
        description: ICD-10 or ICD-10-PCS code for which Merck Manuals will be fetched
        required: true
        schema:
          type: string
        example: I10
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          format: int32
          default: 50
        example: 150
      - name: page
        in: query
        required: false
        schema:
          type: integer
          format: int32
          default: 1
      - name: yyyy-mm-dd
        in: header
        description: Date for which historical data is required
        required: false
        schema:
          type: string
          format: yyyy-mm-dd
      responses:
        '200':
          description: Fetch Merck manuals for given code
          content:
            application/json:
              example:
                content:
                - section: END
                  chapter: Diabetes Mellitus and Disorders of Carbohydrate Metabolism
                  topic: Diabetes Mellitus (DM)
                  url: https://www.merckmanuals.com/professional/endocrine-and-metabolic-disorders/diabetes-mellitus-and-disorders-of-carbohydrate-metabolism/diabetes-mellitus-dm?media=print
                - section: END
                  chapter: Diabetes Mellitus and Disorders of Carbohydrate Metabolism
                  topic: Medications for Diabetes Mellitus Treatment
                  url: https://www.merckmanuals.com/professional/endocrine-and-metabolic-disorders/diabetes-mellitus-and-disorders-of-carbohydrate-metabolism/medications-for-diabetes-mellitus-treatment?media=print
                - section: PED
                  chapter: Endocrine Disorders in Children
                  topic: Diabetes Mellitus in Children and Adolescents
                  url: https://www.merckmanuals.com/professional/pediatrics/endocrine-disorders-in-children/diabetes-mellitus-in-children-and-adolescents?media=print
                totalCount: 3
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Notification'
              example:
                timestamp: '2023-07-14T06:37:03.741+00:00'
                status: 404
                error: Not Found
                message: Not Found
                path: /api/coding/code/merck-manuals/{code}
        '500':
          description: Internal server error
          content:
            application/json:
              example:
                timestamp: '2023-07-13T06:36:22.518+00:00'
                path: /api/coding/code/merck-manual/{code}
                status: 500
                error: Internal Server Error
                requestId: e36d239e-324
      security:
      - bearerAuth: []
  /api/coding/code/merck-manual/document/{doc-id}:
    get:
      tags:
      - Merck Manual API
      summary: Fetches the file content for Merck Manual PDF for HAC quarters before 2022-04-01
      operationId: getMerckManualPDF
      parameters:
      - name: doc-id
        in: path
        description: Merck Manual Document ID
        required: true
        schema:
          type: integer
          format: int32
        example: 463016
      - name: yyyy-mm-dd
        in: header
        description: Date for which historical data is required
        required: false
        schema:
          type: string
          format: yyyy-mm-dd
      responses:
        '200':
          description: Fetches the file content in the form of byte array, response headers and media type as FileType
          content:
            application/pdf:
              schema:
                $ref: '#/components/schemas/Notification'
              example: "  access-control-expose-headers: Content-Disposition\n  cache-control: no-cache,no-store,max-age=0,must-revalidate\n  connection: keep-alive\n  content-disposition: attachment; filename=merck_manual_463589.pdf\n  content-length: 254685\n  content-type: application/pdf\n  date: Fri,02 Nov 2024 06:49:56 GMT\n  expires: 0\n  pragma: no-cache\n  vary: Origin,Access-Control-Request-Method,Access-Control-Request-Headers\n  x-content-type-options: nosniff\n  x-frame-options: DENY\n  x-xss-protection: 0\n"
        '404':
          description: Not found- Sub terms not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Notification'
              example:
                timestamp: '2024-11-02T06:19:48.666+00:00'
                status: 404
                error: Not Found
                message: Not Found
                path: /api/coding/code/merck-manuals/{doc-id}
        '500':
          description: Internal server error
          content:
            application/json:
              example:
                timestamp: '2024-11-02T06:19:48.666+00:00'
                path: /api/coding/code/merck-manual/{doc-id}
                status: 500
                error: Internal Server Error
                requestId: a4796cc7-1
      security:
      - bearerAuth: []
components:
  schemas:
    Notification:
      type: object
      properties:
        error:
          type: array
          items:
            type: string
        warning:
          type: array
          items:
            type: string
        info:
          type: array
          items:
            type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
x-readme:
  explorer-enabled: true
  proxy-enabled: true