What is the K-Smart API?
K-SMART (Kerala Solutions for Managing Administrative Reformation and Transformation) is the Kerala government’s online platform for local body services: birth, death and marriage registration, building permits, property tax, trade licences and more. Information Kerala Mission (IKM) built it for the Local Self Government Department (LSGD). It went live on 1 January 2024 in the state’s 93 municipalities and corporations and later reached every panchayat.
The K-Smart API is the REST backend the K-Smart web and mobile apps call, at https://api.ksmart.lsgkerala.gov.in. Most of it needs a citizen or staff login. 64 GET endpoints serve public reference data with no login and no API key: the districts and local bodies of Kerala, wards, revenue villages, taluks, post offices with PIN codes, the K-Smart service catalogue and form lookup lists. They are listed below with full paths.
Base URL and headers
- Base URL
https://api.ksmart.lsgkerala.gov.in- Method
GET- Required header
X-STATE-CODE: kl(without it every call returns400)- Optional headers
X-LANGUAGE: en,Accept: application/json- Authentication
- None for the endpoints on this page
- CORS
Access-Control-Allow-Origin: *- Format
- JSON, usually a plain array. Names come in English (
name) and Malayalam (nameInLocal).
Sample ids used below: Keralam 502032, Tamil Nadu 502033, India 501077, Kollam district 503002, Grama Panchayat type 5, Adichanalloor GP office code 10132100363, Kollam taluk 134320027, zone 5036301.
Code samples
curl: the 14 districts of Kerala
curl -s 'https://api.ksmart.lsgkerala.gov.in/egov-mdms-service/v1/common-masters/districts/502032' \
-H 'X-STATE-CODE: kl'JavaScript: local body types
const res = await fetch('https://api.ksmart.lsgkerala.gov.in/egov-mdms-service/v1/common-masters/lb-types', {
headers: { 'X-STATE-CODE': 'kl' },
});
const types = await res.json(); // [{ id: 1, name: 'District Panchayat', nameInLocal: 'ജില്ലാ പഞ്ചായത്ത്', ... }]Python: grama panchayats of Kollam with their office phone
import requests
url = 'https://api.ksmart.lsgkerala.gov.in/egov-mdms-service/v1/common-masters/local-bodies/district/503002/5'
for lb in requests.get(url, headers={'X-STATE-CODE': 'kl'}).json():
print(lb['officeCode'], lb['name'], lb['phoneNo'], lb['email'])Kerala ids you will need
Local body types (lbTypeId)
| id | Type | Malayalam | In Kerala |
|---|---|---|---|
| 1 | District Panchayat | ജില്ലാ പഞ്ചായത്ത് | 14 |
| 2 | Block Panchayat | ബ്ലോക്ക് പഞ്ചായത്ത് | 152 |
| 3 | Municipality | മുനിസിപ്പാലിറ്റി | 87 |
| 4 | Municipal Corporation | മുനിസിപ്പല് കോര്പ്പറേഷന് | 6 |
| 5 | Grama Panchayat | ഗ്രാമ പഞ്ചായത്ത് | 941 |
Districts (districtId)
| districtId | District | Malayalam |
|---|---|---|
503001 | Thiruvananthapuram | തിരുവനന്തപുരം |
503002 | Kollam | കൊല്ലം |
503003 | Pathanamthitta | പത്തനംതിട്ട |
503004 | Alappuzha | ആലപ്പുഴ |
503005 | Kottayam | കോട്ടയം |
503006 | Idukki | ഇടുക്കി |
503007 | Ernakulam | എറണാകുളം |
503008 | Thrissur | തൃശ്ശൂര് |
503009 | Palakkad | പാലക്കാട് |
503010 | Malappuram | മലപ്പുറം |
503011 | Kozhikode | കോഴിക്കോട് |
503012 | Wayanad | വയനാട് |
503013 | Kannur | കണ്ണൂര് |
503014 | Kasaragod | കാസര്ഗോഡ് |
Public endpoints
Checked 13 Nov 2026. Every row is a GET that answered 200 with data and no Authorization header. Jump to:
- Geography (all of India)
- Kerala local bodies
- Service catalogue
- Form reference lists
- Birth and death registration
- Institutions
- Office workflow masters
- Found in the app but no data without a login
- Not tested
- Office contacts
Geography (all of India)
| Data | Path | Rows in sample |
|---|---|---|
| Countries | /egov-mdms-service/v1/common-masters/countries | 285 |
| States and UTs | /egov-mdms-service/v1/common-masters/states | 38 |
| States in a country | /egov-mdms-service/v1/common-masters/states/country-id/{countryId} | 38 (India) |
| Districts, all India | /egov-mdms-service/v1/common-masters/districts | 784 |
| Districts in a state | /egov-mdms-service/v1/common-masters/districts/{stateId} | 14 (Kerala), 38 (TN) |
| Post offices in a district | /dmdm-services/v1/post-offices/district/{districtId} | 367 (Kollam), 349 (a TN district) |
| Post offices in a state | /dmdm-services/v1/post-offices/state/{stateId} | 5,110 (Kerala, 2.1 MB), 11,795 (TN, 4.9 MB) |
Kerala local bodies
| Data | Path | Rows in sample |
|---|---|---|
| Local body types | /egov-mdms-service/v1/common-masters/lb-types | 5 |
| Local body types in a district | /egov-mdms-service/v1/common-masters/local-bodies-types/district/{districtId} | 3 |
| All local bodies in Kerala | /egov-mdms-service/v1/common-masters/local-bodies/new-local-bodies | 1,201 |
| Local bodies by district and type | /egov-mdms-service/v1/common-masters/local-bodies/district/{districtId}/{lbTypeId} | 68 |
| Same, phase list | /egov-mdms-service/v1/common-masters/local-bodies/district-phase/{districtId}/{lbTypeId} | 68 |
| One local body | /egov-mdms-service/v1/common-masters/local-bodies/{officeCode} | object |
| Zonal offices | /egov-mdms-service/v1/common-masters/zonal/circle/officeLbCode/{officeCode} | 2 |
| Taluks | /egov-mdms-service/v1/common-masters/taluks/office-lb-code/{officeCode} | 1 |
| All villages in Kerala | /egov-mdms-service/v1/common-masters/villages | 1,942 (880 KB), each with taluk code and the local bodies covering it |
| Villages | /egov-mdms-service/v1/common-masters/villages/office-lb-code/{officeCode} | 2 |
| Villages by local body and taluk | /egov-mdms-service/v1/common-masters/villages/{officeCode}/{talukId} | 2 |
| Current wards | /dmdm-services/v1/ward/officeLbCode/{officeCode} | 21 |
| Ward delimitation years | /dmdm-services/v1/ward/wardYear/{officeCode} (optional ?bitisCurrent=true) | 4 |
| Wards for a year | /dmdm-services/v1/wards/{officeCode}/{year} | 21 |
| Wards for a zone and year | /dmdm-services/v1/all-ward/{officeCode}/{zonalId}/{year} | 21 |
| Post offices of a local body | /dmdm-services/v1/post-offices/office-lb-code/{officeCode} | 7 |
| Institutions in a local body (paged) | /dmdm-services/v1/organizations/search-institutions?searchKey=&page=0&size=10&sort=&officeLbCode={officeCode}&officeTypeId= | 10 per page |
| Building cess offices in a district | /dmdm-services/v1/building-cess/bc-office/{typeOfOfficeId}/{districtId} | 2 |
Service catalogue
| Data | Path | Rows |
|---|---|---|
| Main modules | /egov-mdms-service/v1/common-masters/main-module | 6 |
| Modules | /egov-mdms-service/v1/common-masters/modules | 35 |
| Sub-modules of a module | /egov-mdms-service/v1/common-masters/sub-module/moduleId/{moduleId} | 3 |
| All services | /egov-mdms-service/v1/common-masters/service | 968 |
| Services in a module | /egov-mdms-service/v1/common-masters/service/moduleId/{moduleId} | 55 |
| Services in a sub-module | /egov-mdms-service/v1/common-masters/service/{moduleId}/{subModuleId} | 27 |
| Service details by code | /egov-mdms-service/v1/common-masters/service-general-details/serviceCode/{serviceCode} | object |
| Functional groups | /egov-mdms-service/v1/common-masters/functional-group | 18 |
Form reference lists
| Data | Path | Rows |
|---|---|---|
| Genders | /egov-mdms-service/v1/common-masters/genders | 4 |
| Religions | /egov-mdms-service/v1/common-masters/religions | 10 |
| Registration document types | /egov-mdms-service/v1/common-masters/registration/document-types | 9 |
| Organisation ownership types | /egov-mdms-service/v1/common-masters/organizations/ownership | 11 |
| Organisation service types | /egov-mdms-service/v1/common-masters/organizations/service-type | 9 |
| Institution designations | /egov-mdms-service/v1/common-masters/institution-designation | 177 |
| Financial years | /egov-mdms-service/v1/finance-services/year | 34 |
Birth and death registration
| Data | Path | Rows |
|---|---|---|
| Informant types | /egov-mdms-service/v1/birth-death-services/initiator | 7 |
| Informant relations | /egov-mdms-service/v1/birth-death-services/initiator-relation | 6 |
| Place-of-event institution types | /egov-mdms-service/v1/birth-death-services/institutions-types | 14 |
| Marital statuses | /egov-mdms-service/v1/birth-death-services/marital-statuses | 5 |
| Professions | /egov-mdms-service/v1/birth-death-services/professions | 9 |
| Public place types | /egov-mdms-service/v1/birth-death-services/public-place-type | 21 |
| Qualifications | /egov-mdms-service/v1/birth-death-services/qualifications | 22 |
| Vehicle types | /egov-mdms-service/v1/birth-death-services/vehicle-types | 10 |
Institutions
| Data | Path | Rows |
|---|---|---|
| Departments | /dmdm-services/v1/department | 29 |
| Office types in a department | /dmdm-services/v1/officeType/{deptId} | 13 |
| Institution categories | /dmdm-services/v1/institution-categories | 6 |
| Institution major types | /dmdm-services/v1/major-types | 11 |
| Institution sub-types | /dmdm-services/v1/institutionSubTypes | 60 |
| Sub-types of a major type | /dmdm-services/v1/institutionSubTypes/{majorTypeId} | 18 |
| Institution types | /dmdm-services/v1/institutionTypes | 42 |
| Institution types (new tree) | /dmdm-services/v1/institution-new-types | 774 |
| New types under a sub-type | /dmdm-services/v1/institution-new-types/sub-type-id/{subTypeId} | 156 |
Office workflow masters
| Data | Path | Rows |
|---|---|---|
| Building cess office types | /egov-mdms-service/v1/egov-building-cess/type-of-office | 6 |
| Building cess application types | /egov-mdms-service/v1/egov-building-cess/type-of-application | 20 |
| Building cess service flow | /egov-mdms-service/v1/egov-building-cess/service-flow-setting | 32 |
| Cash denominations | /egov-mdms-service/v1/file-management-service/cash-declaration | 13 |
| File disposal types | /egov-mdms-service/v1/file-management-service/disposal-type | 8 |
| File statuses | /egov-mdms-service/v1/file-management-service/file-status | 5 |
| File types | /egov-mdms-service/v1/file-management-service/file-type | 4 |
Found in the app but no data without a login
| Result | Path |
|---|---|
| 401 needs login | /fin-master-services/master/head/by-service-code/{serviceCode} |
| 400 | /egov-mdms-service/v1/common-masters/service-general-details (bare; use the by-code path) |
| 404 | /egov-mdms-service/v1/egov-hrms/initiator-designations, /egov-mdms-service/v1/egov-hrms/module-service/{m}/{s} |
| 404 | /egov-mdms-service/v1/egov-locations/hospital-type, .../hospitals/{lbId}/{typeId}, .../institution/{lbId}/{typeId} |
| 404 | /egov-mdms-service/v1/file-management-service/modules, .../sub-module |
| 404 | /egov-mdms-service/v1/common-masters/post-offices/office-lb-code/{officeCode}, /dmdm-services/v1/institution-categories/sub-type-id/{id} |
| Empty | /dmdm-services/v1/polling-stations, /dmdm-services/v1/all-wards/year/{officeLbCode}/{zonalId} |
Not tested
The web app knows 405 endpoints. The rest need a login, take personal identifiers (user, application, employee or file numbers), or change data (POST/PUT/PATCH/DELETE), so they were deliberately left alone.
Office contacts
Checked across all of Kerala on 13 Nov 2026:
| Office | Where | What is filled in |
|---|---|---|
| Local bodies (1,200) | /egov-mdms-service/v1/common-masters/local-bodies/district/{districtId}/{lbTypeId}, /egov-mdms-service/v1/common-masters/local-bodies/{officeCode} | landline (phoneNo) and email for all 1,200; mobNo for 529; website for 93; latitude/longitude for 75 |
| Labour (building cess) offices (63) | /dmdm-services/v1/building-cess/bc-office/{typeOfOfficeId}/{districtId} | mobileNo and email for 62; officeHead is a designation, not a name |
| Villages, taluks, zonal offices, post offices | their endpoints above | phone and email fields exist but are always empty |
| Institutions | /dmdm-services/v1/organizations/search-institutions | phoneNo is a placeholder such as NA |
/egov-mdms-service/v1/common-masters/local-bodies/new-local-bodies has no contact fields; use the district-and-type list for those.
The explorer hides mobNo, mobileNo, officeHead, registrarName and tax ids (PAN, TIN, TAN, GSTIN) in its tables; they are still in the raw JSON. Office landlines and emails are shown.
The Find an office page (#find) searches a saved copy of these contacts in data/directory.json. Rebuild it with node scripts/build-directory.mjs (about 230 GET requests, 4 at a time). Opening a local body re-checks its contacts live.
Questions
Does Kerala have a public API for local body data?
There is no published developer programme, but the API behind K-Smart (https://api.ksmart.lsgkerala.gov.in) answers many reference-data requests without a login. This page lists 64 GET endpoints that returned data with no token when checked on 13 Nov 2026.
Do I need an API key or token for the K-Smart API?
Not for the endpoints on this page. Send the header X-STATE-CODE: kl with every request; without it the API answers 400. Endpoints that hold personal records, applications or payments need a K-Smart login and are not covered here.
Can I call the K-Smart API from a web page?
Yes. Responses carry Access-Control-Allow-Origin: *, so fetch() works from any website. Responses are JSON.
How do I get every panchayat, municipality and corporation in Kerala?
Call /egov-mdms-service/v1/common-masters/local-bodies/new-local-bodies for all of them in one list, or /egov-mdms-service/v1/common-masters/local-bodies/district/{districtId}/{lbTypeId} for one district and type. The district-and-type list also has each office’s landline (phoneNo) and email.
What are the district ids and local body type ids?
Kerala’s state id is 502032. District ids run from 503001 (Thiruvananthapuram) to 503014 (Kasaragod), and local body types are 1 to 5. Both tables are on this page.
Is there a rate limit?
K-Smart does not publish one. This is a live government service, so cache responses, keep requests few and spread out, and do not use it for load testing.
Is this the official K-Smart documentation?
No. This reference is unofficial and was written by testing the public endpoints. K-Smart is run by Information Kerala Mission for the Local Self Government Department. For services, use the official portal.