API ReferenceDiagnoses

Update diagnosis

Updates the diagnosis record matching the provided diagnosis_id

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Path parameters

diagnosis_idUUIDRequired

Request

This endpoint expects an object.
namestringOptional
Empty string not allowed.
code_typeenumOptional
Typically, providers submitting claims to Candid are using ICD-10 diagnosis codes. If you are using ICD-10 codes, the primary diagnosis code listed on the claim should use the ABK code_type. If more than one diagnosis is being submitted on a claim, please use ABF for the rest of the listed diagnoses. If you are using ICD-9 diagnosis codes, use BK and BF for the principal and following diagnosis code(s) respectively.
codestringOptional
Empty string not allowed. Should be of the appropriate format for the provided `code_type`. Must obey the ICD-10 format if an ICD-10 code_type is provided, specifically: - Letter - Digit - Digit or the letter `A` or `B` - (Optional) Period `.` - Up to 4 (or as few as 0) letters and digits
present_on_admission_indicatorenumOptionalBeta
For Institutional claims only. A "Y" indicates that the onset occurred prior to admission to the hospital. An "N" indicates that the onset did NOT occur prior to admission to the hospital. A "U" indicates that it is unknown whether the onset occurred prior to admission to the hospital or not.
Allowed values:

Response

This endpoint returns an object.
codestring

Empty string not allowed. Should be of the appropriate format for the provided code_type. Must obey the ICD-10 format if an ICD-10 code_type is provided, specifically:

  • Letter
  • Digit
  • Digit or the letter A or B
  • (Optional) Period .
  • Up to 4 (or as few as 0) letters and digits
code_typeenum

Typically, providers submitting claims to Candid are using ICD-10 diagnosis codes. If you are using ICD-10 codes, the primary diagnosis code listed on the claim should use the ABK code_type. If more than one diagnosis is being submitted on a claim, please use ABF for the rest of the listed diagnoses. If you are using ICD-9 diagnosis codes, use BK and BF for the principal and following diagnosis code(s) respectively.

created_atdatetime
diagnosis_idUUID
encounter_idUUID
updated_atdatetime
namestring
Empty string not allowed.
present_on_admission_indicatorenumBeta
For Institutional claims only. A "Y" indicates that the onset occurred prior to admission to the hospital. An "N" indicates that the onset did NOT occur prior to admission to the hospital. A "U" indicates that it is unknown whether the onset occurred prior to admission to the hospital or not.

Errors

404
Diagnosis Not Found HTTP Error
422
Disallow Multiple Primary Diagnosis HTTP Error