VitalWare API

CptItemData

The following routes are available for this service:
POST	/medRef/coder/cpt	Retrieves cpt/hcpcs related data	Only CPT and HCPCS related data can be retrieved with this
POST GET	/medRef/coder/cpt/{keyword}	Retrieves code related data	Only CPT and HCPCS related data can be retrieved with this

Parameters:
Name	Parameter	Data Type	Required	Description
keyword	path	string	No	General keyword(s) to search on
codeList	path	string	No	Array of HCPCS/CPT codes to find
codeId	path	int	No	Single VitalWare code identifier to return
codeRange	path	BasePropCodeRange	No	Start and optional end code range (both strings) to search on
startRow	path	int	No	Return results starting at the indicated row number
limit	path	int	No	Maxiumum number of results to return (default is 50, maximum is 200)
includeDeletedCodes	path	bool	No	Whether or not to return deleted codes (default is true)
targetDate	path	DateTime	No	Date of service to use for versioned code data, defaults to the date of the request if not provided

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/CptItemData HTTP/1.1 
Host: api.vitalware.com 
Content-Type: text/jsv
Content-Length: length

{
	keyword: String,
	codeList: 
	[
		String
	],
	codeId: 0,
	codeRange: 
	{
		codeStart: String,
		codeEnd: String
	},
	startRow: 0,
	limit: 0,
	includeDeletedCodes: False,
	targetDate: "0001-01-01T12:00:00.0000000-08:00"
}

HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	request: 
	{
		keyword: String,
		codeList: 
		[
			String
		],
		codeId: 0,
		codeRange: 
		{
			codeStart: String,
			codeEnd: String
		},
		startRow: 0,
		limit: 0,
		includeDeletedCodes: False,
		targetDate: "0001-01-01T12:00:00.0000000-08:00"
	},
	response: 
	{
		totalCount: 0,
		records: 
		[
			{
				codeId: String,
				addOnCode: String,
				devReqProc: String,
				medicarePreferred: String,
				code: String,
				codeDisplay: String,
				codeType: String,
				shortDescription: String,
				longDescription: String,
				addedDate: String,
				deletedDate: String,
				globSurg: String,
				em51: String,
				em63: String,
				mcs: String,
				fdaApprovePend: String,
				mediumDescription: String,
				apcCode: String,
				statusIndicator: String,
				statusIndicatorDesc: String,
				adjustedApcPayment: String,
				natPayRate: String,
				minUnadjRate: String,
				labFee: String,
				facMpfs: String,
				nonFacMpfs: String,
				oppsFacilityPrice: String,
				pct10: String,
				pct25: String,
				pct50: String,
				pct75: String,
				pct90: String,
				paymentLimit: String,
				proPct10: String,
				proPct25: String,
				proPct50: String,
				proPct75: String,
				proPct90: String,
				ascApproved: String,
				ascMultiProc: String,
				ascPymtInd: String,
				ascPymtIndDefin: String,
				ascPymtWeight: String,
				workRvu: String,
				mpRvu: String,
				tranNonFacPeRvu: String,
				tranFacPeRvu: String,
				tranNonFacilityPricing: String,
				tranFacilityPricing: String,
				fullImpFacTotal: String,
				fullImpNonFacTotal: String,
				relativeWeight: String,
				isDeleted: String,
				rn: String,
				natUnadjRate: String,
				ascPymtAmt: String
			}
		]
	},
	responseXml: String,
	responseStatus: 
	{
		errorCode: String,
		message: String,
		stackTrace: String,
		errors: 
		[
			{
				errorCode: String,
				fieldName: String,
				message: String
			}
		]
	}
}