Document specs

• PDF documents
• Images
  • Preferred DPI: 150+
  • Non-blurred images
  • Images should not have a high degree of non-linear warping and a high degree of rotation.

API

Reference: https://developer.eka.care/api-reference/general-tools/medical/lab-report/create-records-v2

Contract

{

"status": "queued" | "inprogress"| "completed" | "deleted" | "error",

"error": [{"code": "int","message": "str",}]

"data": {"fhir": <base64encoded>,
				 "output": {"data":[
									   {
									    "test_name": "Amylase Serum,Twopoint-Rate-Dyed",
									    "data": {
									        "value": 71,
									        "unit": "U/L",
									        "unit_processed": "U/l",
									        "normal_range_report": "{\\"h\\":110,\\"l\\":30,\\"t\\":\\"30.0 - 110.0\\",\\"s\\":2}",
									        "normal_range_eka": "{\\"h\\":100,\\"l\\":0,\\"t\\":\\"0.0 - 100.0\\"}",
									        "unit_eka_id": "lu-1006739",
									        "display_range": "30.0 - 110.0"
									    },
									    "normalised_data": {
									        "value": 71,
									        "unit": "U/L",
									        "normal_range_report": "{\\"h\\":110,\\"l\\":30,\\"t\\":\\"30.0 - 110.0\\"}",
									        "normal_range_eka": "{\\"h\\":100,\\"l\\":0,\\"t\\":\\"0.0 - 100.0\\"}",
									        "unit_eka_id": "lu-1006739"
									    },
									    "confidence": 1,
									    "test_eka_id": "lb-9272407360",
									    "loinc_id": "1798-8"
									}
								],
								"pii": 
																	{
									    "<unique_file_path>": [
									        {
									            "PageNum": 1,
									            "DocumentDate": 1715106600,
									            "Patient": {
									                "Age": {
									                    "Years": 25,
									                    "Months": 0,
									                    "Days": 0
									                },
									                "Gender": "male",
									                "Name": "Patient name"
									            },
									            "Report": {
									                "SampleCollectionDate": "01/05/2024 10:03:00",
									                "SampleReceivedDate": "01/05/2024 11:34:00",
									                "GeneratedDate": "01/05/2024 12:48:00",
									                "Doctor": "",
									                "Facility": "LalPath Labs"
									            }
									        }
									    ]
									}

								}
								}
}

Components

Lab test

Every lab test will have

• test_name : Verbatim as written in the lab report
• test_eka_id : Eka identifier for the test
• loinc_id : LOINC identifier for the test
  • NOTE: we use method agnostic LOINC identifiers in majority of the lab tests. Mapping of all Eka identifiers with LOINC identifiers can be obtained from here.

Lab test data (value | unit | range)

Lab test observation is parsed and shared in two variants

Non unit-normalised data (data )

This data is not unit-normalised, meaning this is verbatim as written in the report. The keys comprise

• value : value of the test as given in the report
• unit : unit of the test as given in the report, parsed by OCR (Non post processed). NOTE: at times OCR reads 10^3 u/ml as 103u/ml
• unit_processed : unit of the test as given in the report, parsed by OCR and then processed by eka. In the above example 103u/ml is converted back to 10*3u/ml after applying post processing