COVID-19 Case Submission API
| Parameter | Description |
|---|---|
| USERNAME | Mandatory |
| PASSWORD | Mandatory |
| TESTING_LAB | Code of the testing lab(See lab codes below). Mandatory |
| CASE_ID | |
| CASE_TYPE | Either Initial or Repeat. Mandatory |
| SAMPLE_TYPE | One of: NP Swab, OP Swab, Serum, Sputum or Tracheal Aspirate. Mandatory |
| SAMPLE_NUMBER | Unique identifier for the sample at the testing lab. Mandatory |
| SAMPLE_COLLECTION_DATE | Date format is Y-m-d e.g. 2020-05-31. Mandatory |
| RECEIVED_ON | Date format is Y-m-d e.g. 2020-05-31. Mandatory |
| RESULT | Negative or Positive. Mandatory |
| LAB_CONFIRMATION_DATE | Date format is Y-m-d e.g. 2020-05-31. Mandatory |
| FIRST_FOLLOW_UP_DATE | Date format is Y-m-d e.g. 2020-05-31 |
| FIRST_FOLLOW_UP_RESULT | |
| SECOND_FOLLOW_UP_DATE | Date format is Y-m-d e.g. 2020-05-31 |
| SECOND_FOLLOW_UP_RESULT | |
| THIRD_FOLLOW_UP_DATE | Date format is Y-m-d e.g. 2020-05-31 |
| THIRD_FOLLOW_UP_RESULT | |
| PATIENT_NAMES | Mandatory |
| PATIENT_PHONE | |
| AGE | Mandatory |
| AGE_UNIT | Years, months or days. Mandatory |
| GENDER | F for Female and M for Male. Mandatory |
| OCCUPATION | |
| NATIONALITY | Mandatory |
| NATIONAL_ID | National ID / Passport Number / Alien ID |
| COUNTY | County of residence. Mandatory |
| SUB_COUNTY | Mandatory |
| WARD | |
| VILLAGE | Mandatory |
| HAS_TRAVEL_HISTORY | Either Yes or No |
| TRAVEL_FROM | |
| CONTACT_WITH_CASE | Did the patient have contact with a confirmed case? Either Yes or No |
| CONFIRMED_CASE_NAME | |
| SYMPTOMATIC | Does the patient display symptoms? Either Yes or No |
| SYMPTOMS | Semi-colon delimited list of symptoms |
| SYMPTOMS_ONSET_DATE | Date format is Y-m-d e.g. 2020-05-31 |
| COUNTY_OF_DIAGNOSIS | County where the case was isolated. Mandatory |
| QUARANTINED_FACILITY | The quarantine facility name (if quarantined) |
| HOSPITALIZED | Either Yes, No or Unknown |
| ADMISSION_DATE | Date format is Y-m-d e.g. 2020-05-31 |
Submission Instructions
Data should be submitted as a POST request to the provided end point.
A successful submission yields a JSON output as shown below:
{
"status": "SUCCESS",
"message": 10
}
An unsuccessful submission yields a JSON output similar to the one shown below:
{
"status": "ERROR",
"message": "SAMPLE_NUMBER (AGN/06/023) repeated!"
}
Testing Lab ID
The testing lab value in the above API is the MFL Code of the testing facility. If your facility does not have an MFL Code, we will assign you with a provisional code.
| Facility | Testing Lab ID |
|---|---|
| AMPATHplus - Moi Teaching & Referral Hospital | 00018 |
| Aga Khan Hospital | 12867 |
| Amref Medical Centre - Wilson Airport | 23815 |
| Busia District Hospital | 15834 |
| CDC Kisumu Laboratory | 00036 |
| CDC Nairobi Laboratory | 00034 |
| Coast Province General Hospital | 11289 |
| ILRI Lab | 00033 |
| IOM Kenya | 00037 |
| KEMRI Alupe - Busia | 00025 |
| KEMRI CMR - Nairobi | 00038 |
| KEMRI HIV Lab - Kisumu | 00026 |
| KEMRI P3 - Nairobi | 00024 |
| KEMRI VHF Lab - Nairobi | 00035 |
| KEMRI WRP - Kericho | 00027 |
| KEMRI WRP - Kisumu | 00031 |
| KEMRI Welcome Trust - Kilifi | 00030 |
| KNH CCC - Nairobi | 00028 |
| Kenyatta University Teaching & Referral Hospital | 24979 |
| Kitale District Hospital | 14947 |
| Machakos Level 5 Hospital | 12438 |
| Mahi Mahiu Mobile Laboratory | 00020 |
| Malindi District Hospital | 11555 |
| Meditest Diagnostics Services | 00040 |
| Moi Teaching Referral Hospital | 15204 |
| Mombasa Hospital | 11643 |
| Nairobi Hospital | 13110 |
| Namanga Mobile Laboratory | 00019 |
| National HIV Reference Lab | 00007 |
| National Influenza Centre | 00009 |
| Pathcare Kenya Ltd | 00039 |
| Pathologists Lancet Kenya | 00029 |
| The Nairobi West Hospital | 13115 |
| Wajir County Referral Hospital | 13452 |