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.
Allowed values:

Errors

404
Diagnosis Not Found Httperror
422
Disallow Multiple Primary Diagnosis Httperror