lalpathlabs.com APIlalpathlabs.com ↗
Access Dr. Lal PathLabs test data via API: search pathology tests, get full test details, find collection centers, list cities, and retrieve active offers.
curl -X GET 'https://api.parse.bot/scraper/dfd386be-adc1-4d74-8194-747fd9d834f6/search_tests?query=diabetes' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for pathology tests and health packages by keyword. Returns matching tests with prices, parameters, and collection options.
| Param | Type | Description |
|---|---|---|
| query | string | Search keyword (e.g., 'diabetes', 'thyroid', 'CBC') |
| city_id | integer | City ID for city-specific pricing (default: 2 for Delhi) |
{
"type": "object",
"fields": {
"data": "object with result array",
"status": "integer",
"message": "string"
},
"sample": {
"data": "{\"status\": 200, \"message\": \"Tests and packages list with city level price. \", \"data\": {\"test_report_base_url\": \"https://cdn1.lalpathlabs.com/live/reports/\", \"test_sample_report_url\": \"https://cdn1.lalpathlabs.com/live/reports/sample.png\", \"test_forms_base_url\": \"https://cdn1.lalpathlabs.com/live/forms/\", \"available_order_methods\": [], \"result\": [{\"item_id\": \"Z312\", \"item_name\": \"DIABETES PANEL BASIC\\n\", \"x_is_package\": 0, \"sex\": 2, \"sex_age_action\": 0, \"radiology\": 0, \"is_imaging\": 0, \"subdepartment\": \"Biochemistry\", \"high_age_limit\": 0, \"low_age_limit\": 0, \"components_count\": 5, \"slug_name\": \"diabetes-panel-basic\", \"custom_supplementary\": 0, \"item_type\": 1, \"x_have_supplement_tests\": 1, \"x_have_parameters\": 1, \"x_have_recommendations\": 0, \"x_documents_required\": 0, \"x_supplementary_count\": 2, \"is_ascvd\": 0, \"test_date_mandatory\": 0, \"from_days\": 0, \"to_days\": 0, \"hc_validate_age\": 1, \"vettest\": 0, \"tb_test\": 0, \"lab_department\": \"CCHE\", \"addon_available\": 0, \"msp\": 0, \"test_category\": 2, \"doctor_details_required\": 0, \"x_slots_duration\": null, \"hc_charge_factor\": 1, \"city_name\": \"Delhi\", \"special_hc_charge\": \"-1.00\", \"city_id\": 2, \"is_for_ecom\": 1, \"covid_antibody\": 0, \"fixed_price\": 0, \"covid_srs_id\": 0, \"maternal_test\": 0, \"panel_code\": null, \"nsp_price\": \"440.00\", \"msp_min_price\": null, \"msp_max_price\": null, \"lsp_price\": null, \"wellness_item_id\": null, \"display_order\": 26, \"cgsp_price\": null, \"supplementary_tests\": [{\"suppitem_id\": \"V001\", \"item_relation\": \"Z312\", \"supp_item_free\": 1, \"x_is_for_hc\": 1, \"supp_name\": \"SUGAR CHOICE (F/PP/RANDOM)\", \"test_date_mandatory\": 0, \"from_days\": 0, \"to_days\": 0, \"tb_test\": 0, \"radiology\": 0, \"subdepartment\": null, \"x_slots_duration\": null, \"price\": \"70.00\", \"price_type\": \"NSP\", \"documents\": [], \"parameters_analyte\": [{\"item_id\": \"V001\", \"analyte_name\": \"Glucose\", \"cpt_code\": \"V001\"}], \"parameters\": [{\"item_id\": \"V001\", \"parameter_id\": \"226\", \"mandatory\": 1, \"min_value\": \"0.00\", \"max_value\": \"0.00\", \"measurement_unit\": 0, \"name\": \"SELECT ONE OPTION\", \"remarks\": \"[F]Sugar Fasting [P]Sugar PP [R]Sugar Random\", \"dps\": 1, \"dps_starlims\": 1, \"starlims_code\": \"SGC\", \"validate_checklist\": 0}]}, {\"suppitem_id\": \"B080\", \"item_relation\": \"Z312\", \"supp_item_free\": 1, \"x_is_for_hc\": 1, \"supp_name\": \"HbA1c; GLYCOSYLATED HEMOGLOBIN\", \"test_date_mandatory\": 0, \"from_days\": 0, \"to_days\": 0, \"tb_test\": 0, \"radiology\": 0, \"subdepartment\": null, \"x_slots_duration\": null, \"price\": \"430.00\", \"price_type\": \"NSP\", \"documents\": [], \"parameters_analyte\": [{\"item_id\": \"B080\", \"analyte_name\": \"Estimated average glucose (eAG)\", \"cpt_code\": \"B080\"}, {\"item_id\": \"B080\", \"analyte_name\": \"GLYCOSYLATED HAEMOGLOBIN\", \"cpt_code\": \"B080\"}], \"parameters\": []}], \"parameters_analyte\": [{\"item_id\": \"Z312\", \"analyte_name\": \"Estimated average glucose (eAG)\", \"cpt_code\": \"B080\"}, {\"item_id\": \"Z312\", \"analyte_name\": \"Glucose\", \"cpt_code\": \"V001\"}, {\"item_id\": \"Z312\", \"analyte_name\": \"Sugar choice\", \"cpt_code\": \"V001\"}], \"super_panel_test_codes\": [], \"parameters\": [{\"item_id\": \"Z312\", \"parameter_id\": \"226\", \"mandatory\": 0, \"min_value\": \"0.00\", \"max_value\": \"0.00\", \"measurement_unit\": 0, \"name\": \"SELECT ONE OPTION\", \"remarks\": \"[F]Sugar Fasting [P]Sugar PP [R]Sugar Random\", \"dps\": 1, \"dps_starlims\": 1, \"starlims_code\": \"SGC\", \"validate_checklist\": 0}], \"instructions\": [], \"ref_guide_new\": [{\"item_id\": \"Z312\", \"item_name\": \"DIABETES PANEL BASIC\\n\", \"specimen\": \"2 mL (1 mL min.) Plasma from 1 Grey Top (Sodium Fluoride) tube AND 3 mL (1.5 mL min.) Whole blood in 1 Lavender Top (EDTA) tube. Ship refrigerated. DO NOT FREEZE. Special preparation as per glucose sample selected. F/Fasting sample requires minimum 8 hours fasting. PP/Post prandial sample is 2 hours after starting meal. No restricions for R/Random sample.\", \"room\": \"6 hrs\", \"pretest_info\": \"Special preparation as per glucose sample selected. F/Fasting sample requires minimum 8 hours fasting. PP/Post prandial sample is 2 hours after starting meal. No restricions for R/Random sample.\", \"patient_centric_description\": null, \"components\": \"*Glucose F / PP / R *HbA1c\", \"report\": \"Daily\", \"category\": \"Diabetes\", \"refrigerator\": \"24 hrs\", \"frozen\": \"NA\", \"method\": \"Hexokinase, HPLC\", \"usage\": \"HbA1c provides an index of average blood glucose levels over the past 8 \\u201312 weeks and is a much better indicator of long term glycemic control as compared to blood and urinary glucose determinations. Since HbA1c reflects long term fluctuations in the blood glucose concentration, a diabetic patient who is recently under good control may still have a high concentration of HbA1c. Converse is true for a diabetic previously under good control but now poorly controlled.\", \"general\": \"Diabetes mellitus (DM) is a metabolic disorder leading to high blood sugar levels. It is mainly of 2 types : Type 1 due to destruction of Insulin producing cells in your pancreas and Type 2 due to less production of Insulin or poor response of your cells to Insulin. Type 2 is more common and results in too much sugar circulating in your blood. Common symptoms include increased thirst, frequent urination, hunger, fatigue, weight loss, blurred vision, numbness in hands & feet. If untreated, all organs of the body can suffer damage.\", \"sample_path\": \"https://dlpld365dlstorage.blob.core.windows.net/documents-dlplmdm/mdm_service/33552886-afa6-f011-bbd3-7ced8da00338/mdm_azureattachmentlink/8023fd94-8ec0-f011-bbd3-7c1e523b7f1f/Z312.pdf\"}], \"documents\": [], \"instant_results\": [{\"item_id\": \"Z312\", \"code\": \"F\", \"result\": \"Sugar Fasting\", \"parameter_id\": null}, {\"item_id\": \"Z312\", \"code\": \"R\", \"result\": \"Sugar Random\", \"parameter_id\": null}, {\"item_id\": \"Z312\", \"code\": \"P\", \"result\": \"Sugar PP\", \"parameter_id\": null}], \"panel_test_codes\": [\"B080\", \"V001\"], \"test_faq\": {}, \"addons\": [], \"price\": \"440.00\", \"price_type\": \"NSP\", \"is_dcp_panel\": false, \"test_phlebo_type\": \"BLOOD\", \"category_name\": \"Diabetes\", \"icon_name\": \"01-Default\", \"category_count\": 2, \"is_hc_available\": true}, {\"item_id\": \"Z285\", \"item_name\": \"DIABETES PANEL 1\", \"x_is_package\": 1, \"sex\": 2, \"sex_age_action\": 0, \"radiology\": 0, \"is_imaging\": 0, \"subdepartment\": null, \"high_age_limit\": 0, \"low_age_limit\": 0, \"components_count\": 11, \"slug_name\": \"diabetes-panel-1\", \"custom_supplementary\": 0, \"item_type\": 2, \"x_have_supplement_tests\": 1, \"x_have_parameters\": 0, \"x_have_recommendations\": 0, \"x_documents_required\": 0, \"x_supplementary_count\": 84, \"is_ascvd\": 0, \"test_date_mandatory\": 0, \"from_days\": 0, \"to_days\": 0, \"hc_validate_age\": 1, \"vettest\": 0, \"tb_test\": 0, \"lab_department\": \"PR\", \"addon_available\": 0, \"msp\": 0, \"test_category\": 3, \"doctor_details_required\": 0, \"x_slots_duration\": null, \"hc_charge_factor\": 2, \"city_name\": \"Delhi\", \"special_hc_charge\": \"-1.00\", \"city_id\": 2, \"is_for_ecom\": 1, \"covid_antibody\": 0, \"fixed_price\": 0, \"covid_srs_id\": 0, \"maternal_test\": 0, \"panel_code\": null, \"nsp_price\": \"1280.00\", \"msp_min_price\": null, \"msp_max_price\": null, \"lsp_price\": null, \"wellness_item_id\": null, \"display_order\": 5, \"cgsp_price\": null, \"supplementary_tests\": [{\"suppitem_id\": \"B023\", \"item_relation\": \"Z285\", \"supp_item_free\": 1, \"x_is_for_hc\": 1, \"supp_name\": \"CREATININE, SERUM\", \"test_date_mandatory\": 0, \"from_days\": 0, \"to_days\": 0, \"tb_test\": 0, \"radiology\": 0, \"subdepartment\": null, \"x_slots_duration\": null, \"price\": \"150.00\", \"price_type\": \"NSP\", \"documents\": [], \"parameters_analyte\": [{\"item_id\": \"B023\", \"analyte_name\": \"Creatinine\", \"cpt_code\": \"B023\"}, {\"item_id\": \"B023\", \"analyte_name\": \"GFR Category\", \"cpt_code\": \"B023\"}, {\"item_id\": \"B023\", \"analyte_name\": \"GFR Estimated\", \"cpt_code\": \"B023\"}], \"parameters\": []}, {\"suppitem_id\": \"Z359\", \"item_relation\": \"Z285\", \"supp_item_free\": 1, \"x_is_for_hc\": 1, \"supp_name\": \"DIABETES SCREEN\", \"test_date_mandatory\": 0, \"from_days\": 0, \"to_days\": 0, \"tb_test\": 0, \"radiology\": 0, \"subdepartment\": null, \"x_slots_duration\": null, \"price\": \"580.00\", \"price_type\": \"NSP\", \"documents\": [], \"parameters_analyte\": [{\"item_id\": \"Z359...",
"status": "success",
"_truncated": "Use get_full_output(test_index=0) for complete data."
}
}About the lalpathlabs.com API
The Dr. Lal PathLabs API exposes 7 endpoints covering India's largest diagnostic lab chain — from keyword-based test search and full analyte breakdowns to nearest collection center lookup and live promotional offers. The get_test_details endpoint alone returns specimen requirements, pretest preparation, report delivery details, and city-specific pricing by passing one or more item IDs. Coverage spans hundreds of tests and health packages across all cities served by the lab network.
Test Search and Detail
The search_tests endpoint accepts a query string (e.g. 'thyroid', 'CBC', 'diabetes') and an optional city_id integer to return city-adjusted prices alongside matching tests and packages. For deeper inspection, get_test_details takes a item_id string — single or comma-separated — and an optional city_name parameter. Its response includes a result array with analyte parameters, supplementary tests, specimen type, pretest instructions, and report turnaround data. Common item IDs include Z021 for CBC and S153 for thyroid panels.
Test Catalog and Categories
list_all_tests returns a paginated list of every test on the Dr. Lal PathLabs menu, structured as a data object with a result array. list_categories returns all available diagnostic categories — conditions and specialities — that map to test groupings, useful for building filter UIs or browsing by health concern.
Locations and Offers
list_cities returns every city Dr. Lal PathLabs serves, including city_id, city_name, state_name, city_code, and service configuration flags, along with a TotalRecord count. The find_nearest_center endpoint takes a city string and optional state to return nearby collection center details. get_special_offers returns active coupon objects with Name, Description, Banner URL, CouponCategory, and terms — no parameters required.
- Build a diagnostic test comparison tool that pulls city-specific pricing from
get_test_detailsfor multiple cities simultaneously. - Populate a health app's test catalog using
list_all_testsand enrich each entry with analyte parameters fromget_test_details. - Create a location finder widget that uses
list_citiesto populate a dropdown andfind_nearest_centerto show nearby labs. - Aggregate active discount offers from
get_special_offersand surface coupon banners to users before checkout. - Index pathology tests by category using
list_categoriesto build a browsable condition-based directory. - Automate price monitoring across cities by querying
search_testswith a fixed keyword and rotatingcity_idvalues. - Build a pre-test preparation guide by extracting pretest and specimen fields from
get_test_detailsfor a curated list of tests.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Dr. Lal PathLabs have an official public developer API?+
What does `get_test_details` return beyond price?+
city_name parameter), the endpoint returns analyte parameters, supplementary test associations, specimen requirements, pretest preparation instructions, and report delivery details — all within the result array of the Data object.Does `find_nearest_center` return GPS coordinates or only text-based location data?+
result array of collection center objects for the requested city. The response schema listed does not explicitly expose latitude/longitude fields. You can fork this API on Parse and revise it to add coordinate extraction if the underlying center data includes it.Can I retrieve home sample collection availability or booking slots through this API?+
How does `list_all_tests` handle large catalogs — is there pagination control?+
data object with a result array but does not currently expose user-controlled pagination parameters such as page number or page size. All available tests are returned in the default response.