openapi: 3.2.0 info: title: Core Service Code History APIs 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: Code History APIs paths: /api/coding/code/{codetype}/{code}/history: get: tags: - Code History APIs summary: Fetches the complete history for a code. operationId: codeHistory parameters: - name: codetype in: path required: true schema: type: string enum: - cpt - hcpcs - i10_pcs - i10_cm - i9v1 - i9v3 - name: code in: path description: Code for which history is required required: true schema: type: string example: 99213 - 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: Complete code history of code content: application/json: example: - changeEffectiveDate: '2021-01-01 00:00:00' status: Changed changeSummary: Officially recognized, Other, Changed fullInfo:
Office or other outpatient visit for the evaluation and management of an established patient, which requires a medically appropriate history and/or examination and low level of medical decision making. When using time for code selection, 20-29 minutes of total time is spent on the date of the encounter.EST OUTPT L3 EXP PROB H&E LOW COMPLX MED DEC
char48Info:
OFFICEOFC/OUTPATIENT ESTABLISHED LOWOUTPT VISIT E&M EST MDM 20-29MOD SEVERITY 15 MIN
char35Info:
OFFICE OOFC/P EST LOWOUTPT E&M ESTAB 20-29MOD 15 MIN
- changeEffectiveDate: '2013-01-01 00:00:00'
status: Changed
changeSummary: Officially recognized, Other, Changed
fullInfo: '
Office or other outpatient visit for the evaluation and management of an established patient, which requires at least 2 of these 3 key components: An expanded problem focused history; An expanded problem focused examination; Medical decision making of low complexity. Counseling and coordination of care with other physicians, other qualified health care professionals, or agencies are provided consistent with the nature of the problem(s) and the patient''s and/or family''s needs. Usually, the presenting problem(s) are of low to moderate severity. Typically, 15 minutes are spent face-to-face with the patient and/or family.EST OUTPT L3 EXP PROB H&E LOW COMPLX MED DEC'
char48Info:
OFFICE OUTPATIENT VISITOFC/OUTPT 15 MINUTESMIN
char35Info:
OFFICEOFC/OUTPATIENT VISIT ESTOUTPT E&M ESTAB LOW-MOD 15 MIN
- changeEffectiveDate: '2004-01-01 00:00:00'
status: Changed
changeSummary: Officially recognized, Other, Changed
fullInfo: '
Office or other outpatient visit for the evaluation and management of an established patient, which requires at least 2 of these 3 key components: An expanded problem focused history; An expanded problem focused examination; Medical decision making of low complexity. Counseling and coordination of care with other providers or agencies are provided consistent with the nature of the problem(s) and the patient''s and/or family''s needs. Usually, the presenting problem(s) are of low to moderate severity. Physicians typically spend 15 minutes face-to-face with the patient and/or family.EST OUTPT L3 EXP PROB H&E LOW COMPLX MED DEC'
char48Info:
OFFICE OUTPATIENT VISITOFC/OUTPT 15 MINUTESMIN
char35Info:
OFFICEOFC/OUTPATIENT VISIT ESTOUTPT E&M ESTAB LOW-MOD 15 MIN
- changeEffectiveDate: '2003-01-01 00:00:00'
status: Changed
changeSummary: Officially recognized, Other, Changed
fullInfo: '
Office or other outpatient visit for the evaluation and management of an established patient, which requires at least two of these three key components: an expanded problem focused history; an expanded problem focused examination; medical decision making of low complexity. Counseling and coordination of care with other providers or agencies are provided consistent with the nature of the problem(s) and the patient''s and/or family''s needs. Usually, the presenting problem(s) are of low to moderate severity. PhEST OUTPT L3 EXP PROB H&E LOW COMPLX MED DEC'
char48Info: There are no differences in these versions.
char35Info: There are no differences in these versions.
- changeEffectiveDate: '2000-01-01 00:00:00'
status: Changed
changeSummary: Officially recognized, Other, Changed
fullInfo: '
Office or other outpatient visit for the evaluation and management of an established patient, which requires at least two of these three key components: an expanded problem focused history; an expanded problem focused examination; medical decision making of low complexity. Counseling and coordination of care with other providers or agencies are provided consistent with the nature of the problem(s) and the patient''s and/or family''s needs. Usually, the presenting problem(s) are of low to moderate severity. Physicians typically spend 15 minutes face-to-face with the patient and/or family.EST OUTPT L3 EXP PROB H&E LOW COMPLX MED DEC'
char48Info: There are no differences in these versions.
char35Info: There are no differences in these versions.
- changeEffectiveDate: '1994-01-01 00:00:00'
status: Changed
changeSummary: Officially recognized, Other, Changed
fullInfo:
OFFIC/OUTPT VISIT E&M ESTOUTPT L3 EXP PROB H&E LOW-MOD SEVERITY 15MINCOMPLX MED DEC
char48Info: There are no differences in these versions.
char35Info: There are no differences in these versions.
- changeEffectiveDate: '1993-01-01 00:00:00'
status: New
changeSummary: Officially recognized, Other, New
fullInfo: There are no differences in these versions.
char48Info: There are no differences in these versions.
char35Info: There are no differences in these versions.
'400':
description: 'Bad Request: Some parameters were invalid'
content:
application/json:
schema:
$ref: '#/components/schemas/Notification'
example:
error:
- The code provided '999' in this web service request is not a valid 'cpt' code.
warning: null
info: null
'500':
description: Internal server error
content:
application/json:
example:
timestamp: '2022-07-06T07:22:01.017+00:00'
path: /api/coding/code/cpt/11000/history
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