VitalWare API

<back to all web services

MsdrgGroup

The following routes are available for this service:
POST/grouper/msdrgGroupGroups code specific claim data
Parameters:
NameParameterData TypeRequiredDescription
rawRecordStatuspathstringNo
retainRawFilespathboolNo
codeDatapathMsdrgInputYesCode data containing patient information and diagnois and procedure code(s)

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /jsv/reply/MsdrgGroup HTTP/1.1 
Host: api.vitalware.com 
Content-Type: text/jsv
Content-Length: length

{
	rawRecordStatus: hide,
	retainRawFiles: False,
	codeData: 
	{
		grouperLogicDirective: auto,
		grouperLogicUsed: auto,
		patientName: String,
		mrn: String,
		mpn: String,
		accountNumber: String,
		admitDate: "0001-01-01T12:00:00.0000000-08:00",
		dischargeDate: "0001-01-01T12:00:00.0000000-08:00",
		dischargeStatusCode: String,
		primaryPayerCode: String,
		lengthOfStay: 0,
		patientDob: "0001-01-01T12:00:00.0000000-08:00",
		patientAge: 0,
		admitCode: 
		{
			codeId: 0,
			code: String,
			codeTypeId: 0,
			codeType: String
		},
		hacLogic: X,
		codeSetPrefix: icd10,
		diagnoses: 
		[
			{
				detail: 
				{
					codeId: 0,
					code: String,
					codeTypeId: 0,
					codeType: String
				},
				presentOnAdmission: String
			}
		],
		procedures: 
		[
			{
				detail: 
				{
					codeId: 0,
					code: String,
					codeTypeId: 0,
					codeType: String
				},
				procDate: "0001-01-01T12:00:00.0000000-08:00"
			}
		],
		optionalInfo: String,
		patientGender: 0
	}
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	request: 
	{
		rawRecordStatus: hide,
		retainRawFiles: False,
		codeData: 
		{
			grouperLogicDirective: auto,
			grouperLogicUsed: auto,
			patientName: String,
			mrn: String,
			mpn: String,
			accountNumber: String,
			admitDate: "0001-01-01T12:00:00.0000000-08:00",
			dischargeDate: "0001-01-01T12:00:00.0000000-08:00",
			dischargeStatusCode: String,
			primaryPayerCode: String,
			lengthOfStay: 0,
			patientDob: "0001-01-01T12:00:00.0000000-08:00",
			patientAge: 0,
			admitCode: 
			{
				codeId: 0,
				code: String,
				codeTypeId: 0,
				codeType: String
			},
			hacLogic: X,
			codeSetPrefix: icd10,
			diagnoses: 
			[
				{
					detail: 
					{
						codeId: 0,
						code: String,
						codeTypeId: 0,
						codeType: String
					},
					presentOnAdmission: String
				}
			],
			procedures: 
			[
				{
					detail: 
					{
						codeId: 0,
						code: String,
						codeTypeId: 0,
						codeType: String
					},
					procDate: "0001-01-01T12:00:00.0000000-08:00"
				}
			],
			optionalInfo: String,
			patientGender: 0
		}
	},
	inputRecords: 
	[
		{
			line: String,
			lineLength: 6
		}
	],
	outputRecords: 
	[
		{
			line: String,
			lineLength: 6
		}
	],
	results: 
	[
		{
			grouperSystemKey: auto,
			grouperVersion: 0,
			awi: 0,
			drgs: 
			[
				{
					seriesId: 0,
					seriesGrouperId: 0,
					drgStateId: 0,
					drgState: String,
					drgDescription: String,
					glos: 0,
					alos: 0,
					drgId: 0,
					drg: String,
					codeTypeId: 0,
					codeType: String,
					relWeight: 0,
					estimatedRevenue: 0,
					ccMcc: 0,
					msIndicator: 0,
					mdc: 0,
					claimId: 0,
					claimDrgId: 0,
					soi: 0,
					rom: 0,
					errors: 
					[
						{
							errorKey: String,
							errorReason: String
						}
					],
					updatedBy: String
				}
			],
			drgReturnCode: String,
			grouperReturnCode: String,
			diagnosisCodeCount: 0,
			procedureCodeCount: 0,
			diagnosisPrincipalFlag: String,
			diagnosisPrincipalHac: String,
			diagnoses: 
			[
				{
					sequence: 0,
					detail: 
					{
						codeId: 0,
						code: String,
						codeTypeId: 0,
						codeType: String
					},
					hasFlags: False,
					returnFlags: 
					[
						{
							flagId: 0,
							edit: String,
							flagTypeKey: String,
							vwShortIndicator: String,
							flagDescription: String
						}
					],
					hasHacCriteria: False,
					hacCriteria: 
					[
						{
							flagId: 0,
							edit: String,
							flagTypeKey: String,
							vwShortIndicator: String,
							flagDescription: String
						}
					],
					hasHacUsage: False,
					hacUsage: 
					[
						{
							flagId: 0,
							edit: String,
							flagTypeKey: String,
							vwShortIndicator: String,
							flagDescription: String
						}
					]
				}
			],
			procedures: 
			[
				{
					sequence: 0,
					detail: 
					{
						codeId: 0,
						code: String,
						codeTypeId: 0,
						codeType: String
					},
					hasFlags: False,
					returnFlags: 
					[
						{
							flagId: 0,
							edit: String,
							flagTypeKey: String,
							vwShortIndicator: String,
							flagDescription: String
						}
					],
					hasHacCriteria: False,
					hacCriteria: 
					[
						{
							flagId: 0,
							edit: String,
							flagTypeKey: String,
							vwShortIndicator: String,
							flagDescription: String
						}
					]
				}
			],
			hacUniqueCount: 0,
			hacStatus: String,
			costWeight: 0,
			grouperExecuteDate: 2024-11-21T06:29:38.0704745+00:00
		}
	],
	responseStatus: 
	{
		errorCode: String,
		message: String,
		stackTrace: String,
		errors: 
		[
			{
				errorCode: String,
				fieldName: String,
				message: String
			}
		]
	}
}