API ReferenceDiagnoses

Create diagnosis

Creates a new diagnosis for an encounter

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Request

This endpoint expects an object.
codestringRequired

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_typeenumRequired

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.

encounter_idUUIDRequired
namestringOptional
Empty string not allowed.
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.

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.