Medical diagnoses

An injury incident can have one or more associated medical diagnoses. Note that, in the data model, they are stored in the InjuryDiagnosis entity. But in the user interface, they are referred to as Medical Diagnoses. Thus, in Cloud API, they are managed by the MedicalDiagnosis schema.

For more information on the business functionality of medical diagnoses, see the Application Guide.

Querying for medical diagnoses

Use the following endpoints for query for the medical diagnoses on an injury incident.

  • GET /claim/v1/claims/{claimId}/injury-incidents/{incidentId}/
medical-diagnoses
  • GET /claim/v1/claims/{claimId}/injury-incidents/{incidentId}/
medical-diagnoses/{medicalDiagnosisId}

For example, the following request retrieves the medical diagnoses for injury incident cc:888 on claim cc:77.

Command

GET /claim/v1/claims/cc:77/injury-incidents/cc:888/medical-diagnoses

Response

{
    "count": 1,
    "data": [
        {
            "attributes": {
                "icdCode": {
                    "displayName": "A00.0",
                    "id": "icd10:A00.0",
                    "type": "ICDCode",
                    "uri": "/admin/v1/icd-codes/icd10:A00.0"
                },
                "id": "cc:77077",
                "isPrimary": true,
                "provider": {
                    "displayName": "Beverly Cushing",
                    "id": "cc:4040",
                    "type": "ClaimContact",
                    "uri": "/claim/v1/claims/cc:77/contacts/cc:4040"
                }
            },
            ...

Creating medical diagnoses

Use the following endpoint to create a medical diagnosis:

  • POST /claim/v1/claims/{claimId}/injury-incidents/{incidentId}/
medical-diagnoses

The are two required fields:

  • icdCode, which is a JSON object with an id property that references the ID for an existing ICD code. (For more information on ICD codes, see Managing ICD codes.)

  • provider, which is a JSON object with an id property that references the ID for an existing contact on the claim.

For example, suppose that on claim cc:11, there is an injury incident with the ID of cc:222. Beverly Cushing is a doctor on the claim with ID cc:4040. She diagnoses the injury incident as being caused by cholera. The ICD code for cholera has an ID of icd10:A00.0. The following request creates this medical diagnosis.

Command

POST /claim/v1/claims/cc:11/injury-incidents/cc:222/medical-diagnoses

Request

{
  "data": {
    "attributes": {
        "icdCode": {
            "id": "icd10:A00.0"
        },
        "provider": {
            "id": "cc:4040"
        }
    }
  }
}

PATCHing and DELETEing medical diagnoses

Use the following endpoint to PATCH an existing medical diagnosis:

  • PATCH /claim/v1/claims/{claimId}/injury-incidents/{incidentId}/
medical-diagnoses/{medicalDiagnosisId}

For example, the following request specifies that, for injury incident cc:222 on claim cc:11, medical diagnosis cc:77077 was made on October 10, 2024.

Command

PATCH /claim/v1/claims/cc:11/injury-incidents/cc:222/medical-diagnoses/cc:77077

Request

{
  "data": {
    "attributes": {
        "startDate": "2024-10-10"
    }
  }
}

Use the following endpoint to DELETE an existing medical diagnosis:

  • DELETE /claim/v1/claims/{claimId}/injury-incidents/{incidentId}/
medical-diagnoses/{medicaldiagnosisId}

For example, the following request deletes medical diagnosis cc:77077 for injury incident cc:222 on claim cc:11.

Command

DELETE /claim/v1/claims/cc:11/injury-incidents/cc:222/medical-diagnoses/cc:77077