K-Smart LookupUnofficial · K-Smart API and Kerala office directory

K-Smart API reference

The public, login-free endpoints of Kerala’s K-Smart local body platform, with full paths, ids and code samples. Unofficial, and tested by hand on 13 Nov 2026.

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 returns 400)
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)

idTypeMalayalamIn Kerala
1District Panchayatജില്ലാ പഞ്ചായത്ത്14
2Block Panchayatബ്ലോക്ക് പഞ്ചായത്ത്152
3Municipalityമുനിസിപ്പാലിറ്റി87
4Municipal Corporationമുനിസിപ്പല്‍ കോര്‍പ്പറേഷന്‍6
5Grama Panchayatഗ്രാമ പഞ്ചായത്ത്941

Districts (districtId)

districtIdDistrictMalayalam
503001Thiruvananthapuramതിരുവനന്തപുരം
503002Kollamകൊല്ലം
503003Pathanamthittaപത്തനംതിട്ട
503004Alappuzhaആലപ്പുഴ
503005Kottayamകോട്ടയം
503006Idukkiഇടുക്കി
503007Ernakulamഎറണാകുളം
503008Thrissurതൃശ്ശൂര്‍
503009Palakkadപാലക്കാട്
503010Malappuramമലപ്പുറം
503011Kozhikodeകോഴിക്കോട്
503012Wayanadവയനാട്
503013Kannurകണ്ണൂര്‍
503014Kasaragodകാസര്‍ഗോഡ്

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)

DataPathRows in sample
Countries/egov-mdms-service/v1/common-masters/countries285
States and UTs/egov-mdms-service/v1/common-masters/states38
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/districts784
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

DataPathRows in sample
Local body types/egov-mdms-service/v1/common-masters/lb-types5
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-bodies1,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/villages1,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

DataPathRows
Main modules/egov-mdms-service/v1/common-masters/main-module6
Modules/egov-mdms-service/v1/common-masters/modules35
Sub-modules of a module/egov-mdms-service/v1/common-masters/sub-module/moduleId/{moduleId}3
All services/egov-mdms-service/v1/common-masters/service968
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-group18

Form reference lists

DataPathRows
Genders/egov-mdms-service/v1/common-masters/genders4
Religions/egov-mdms-service/v1/common-masters/religions10
Registration document types/egov-mdms-service/v1/common-masters/registration/document-types9
Organisation ownership types/egov-mdms-service/v1/common-masters/organizations/ownership11
Organisation service types/egov-mdms-service/v1/common-masters/organizations/service-type9
Institution designations/egov-mdms-service/v1/common-masters/institution-designation177
Financial years/egov-mdms-service/v1/finance-services/year34

Birth and death registration

DataPathRows
Informant types/egov-mdms-service/v1/birth-death-services/initiator7
Informant relations/egov-mdms-service/v1/birth-death-services/initiator-relation6
Place-of-event institution types/egov-mdms-service/v1/birth-death-services/institutions-types14
Marital statuses/egov-mdms-service/v1/birth-death-services/marital-statuses5
Professions/egov-mdms-service/v1/birth-death-services/professions9
Public place types/egov-mdms-service/v1/birth-death-services/public-place-type21
Qualifications/egov-mdms-service/v1/birth-death-services/qualifications22
Vehicle types/egov-mdms-service/v1/birth-death-services/vehicle-types10

Institutions

DataPathRows
Departments/dmdm-services/v1/department29
Office types in a department/dmdm-services/v1/officeType/{deptId}13
Institution categories/dmdm-services/v1/institution-categories6
Institution major types/dmdm-services/v1/major-types11
Institution sub-types/dmdm-services/v1/institutionSubTypes60
Sub-types of a major type/dmdm-services/v1/institutionSubTypes/{majorTypeId}18
Institution types/dmdm-services/v1/institutionTypes42
Institution types (new tree)/dmdm-services/v1/institution-new-types774
New types under a sub-type/dmdm-services/v1/institution-new-types/sub-type-id/{subTypeId}156

Office workflow masters

DataPathRows
Building cess office types/egov-mdms-service/v1/egov-building-cess/type-of-office6
Building cess application types/egov-mdms-service/v1/egov-building-cess/type-of-application20
Building cess service flow/egov-mdms-service/v1/egov-building-cess/service-flow-setting32
Cash denominations/egov-mdms-service/v1/file-management-service/cash-declaration13
File disposal types/egov-mdms-service/v1/file-management-service/disposal-type8
File statuses/egov-mdms-service/v1/file-management-service/file-status5
File types/egov-mdms-service/v1/file-management-service/file-type4

Found in the app but no data without a login

ResultPath
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:

OfficeWhereWhat 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 officestheir endpoints abovephone and email fields exist but are always empty
Institutions/dmdm-services/v1/organizations/search-institutionsphoneNo 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.