டெவலப்பர் API

சிவில் தரவு, புதுமை, மாவட்ட சுயவிவரங்களுக்கான பொது read-only endpoints — அனைத்தும் லங்காவாவிலிருந்து.

தொடங்குதல்

அனைத்து endpoints-ம் same-origin JSON APIs. படிக்க API key தேவையில்லை. பதில்களில் புதுமை tier மற்றும் உள்ளக மூல பாதைகள் உள்ளன.

Base URL: /api/v1

Data export

Download curated datasets from the Lankawa API.

District boundaries

Download GeoJSON Download CSV

Election results

Download JSON Download CSV

Public services

Download JSON Download CSV

Fuel history

Download JSON Download CSV

Land change indices

Download JSON Download CSV

Foreign debt composition

Download JSON Download CSV

Census 2024 living conditions

Download JSON Download CSV

Census 2024 age structure

Download JSON Download CSV

Embeddable widgets

Same-origin iframe widgets for today, pulse, fuel, and FX.

Open embed preview

Widget SDK snippet

Beyond iframes — drop-in script scaffold that mounts a same-origin embed. Prefer iframe for production until the npm package ships.

<div id="lankawa-widget" data-widget="brief"></div>
<script src="https://lankawa.vercel.app/embed/widget.js" defer></script>

Signed change webhooks

HMAC helper ready; outbound delivery not enabled yet. When delivery ships, partners will verify changelog payloads with HMAC-SHA256 (header X-Lankawa-Signature: sha256=<hex>). Helper: signWebhookBody / verifyWebhookSignature in src/lib/webhook-hmac.ts. Set LANKAWA_WEBHOOK_SECRET only once a delivery endpoint is wired.

X-Lankawa-Signature: sha256=<hmac-sha256-hex-of-body>

Endpoints

GET/api/v1/health

மூல ஆரோக்கியம்

பதிவு செய்யப்பட்ட அனைத்து தரவு மூலங்களுக்கும் புதுமை tier மற்றும் கடைசி சோதனை timestamps.

{ "generatedAt": "2026-07-19T06:00:00.000Z", "sources": [...] }

GET/api/v1/pulse

நேரடி நிலை

தற்போதைய நாணய விகிதங்கள், எரிபொருள் விலைகள், வெள்ள நிலைய எண்ணிக்கைகள் மற்றும் தொடர்புடைய அளவீடுகள்.

{ "generatedAt": "...", "metrics": [...], "flood": [...], "sources": [...] }

GET/api/v1/stress

Lanka Stress Index

FX, flood, power, Met, landslide மற்றும் dengue சமிக்ஞைகளிலிருந்து 0–100 civic stress — அதிகாரப்பூர்வ அரசு குறியீடு அல்ல.

{ "score": 28, "tier": "watch", "components": [...], "isPartial": false, "methodology": [...] }

GET/api/v1/districts

மாவட்ட பட்டியல்

மக்கள்தொகை, பரப்பளவு, மாகாண metadata உடன் 25 இலங்கை மாவட்டங்கள்.

{ "districts": [{ "slug": "colombo", "name": "Colombo", ... }] }

GET/api/v1/districts/{slug}

மாவட்ட விவரம்

slug மூலம் ஒற்றை மாவட்ட சுயவிவரம்.

{ "slug": "colombo", "name": "Colombo", "population": 2427285, ... }

GET/api/v1/provinces

Province list

All 9 Sri Lankan provinces with slug and trilingual names.

{ "count": 9, "provinces": [{ "slug": "western", "name": "Western", ... }] }

GET/api/v1/provinces/{slug}

Province detail

Single province profile with aggregated population, area, and district list.

{ "slug": "western", "districtCount": 3, "population": 5846400, ... }

GET/api/v1/elections

Presidential election 2024

National summary and district-level first-preference results with provenance paths.

{ "election": { "id": "presidential-2024", ... }, "districts": [...] }

GET/api/v1/elections/parliamentary

Parliamentary election 2024

National seat summary and all electoral district results.

{ "election": { "id": "parliamentary-2024", ... }, "districts": [...] }

GET/api/v1/elections/parliamentary/{slug}

Parliamentary electoral district

Seat allocation for a single electoral district.

{ "slug": "colombo", "totalSeats": 18, "seats": { "npp": 14, ... } }

GET/api/v1/services?district=colombo&type=hospital

Public services

Filter hospitals, schools, and GN offices by district, type, or search query.

{ "count": 2, "facilities": [{ "id": "colombo-national-hospital", ... }] }

GET/api/v1/services/{id}

Service facility detail

Single public service facility by ID.

{ "id": "colombo-national-hospital", "type": "hospital", ... }

GET/api/v1/flood/history?station=Peradeniya&limit=24

Flood station history

Historical water levels for a river monitoring station with freshness tier.

{ "points": [{ "timestamp": "...", "waterLevel": 1.39 }], "tier": "fresh" }

GET/api/v1/fuel/history?days=90

Fuel price history

Octane partner API வழி CPC petrol 92 மற்றும் auto diesel விலை series.

{ "days": 90, "series": [{ "fuelType": "petrol_92", "points": [...] }] }

GET/api/v1/fuel/revisions?limit=8

Fuel revision steps

CPC petrol 92 and auto diesel official revision events with price deltas from Octane.

{ "limit": 8, "steps": [{ "fuelType": "petrol_92", "deltaLkr": -20 }] }

GET/api/v1/budget

தேசிய பட்ஜெட்

FY 2024/25 மற்றும் 2025/26 revenue, expenditure மற்றும் sector allocations (seed).

{ "fiscalYears": [{ "id": "fy2025-26", "revenue": 4580, ... }] }

GET/api/v1/health/dengue

வாராந்திர டெங்கு புள்ளிவிவரங்கள்

Epidemiology Unit seed dataset வழி மாவட்ட-level டெங்கு case counts.

{ "nationalTotal": 3842, "districts": [{ "slug": "colombo", "cases": 612 }] }

GET/api/v1/property

Property price bands

District-level median land price bands with low/high ranges.

{ "districts": [{ "slug": "colombo", "medianPerPerch": 9500000, ... }] }

GET/api/v1/elections/history

Election history

Multi-cycle presidential summaries and parliamentary seat history.

{ "presidential": { "cycles": [{ "year": 2024, ... }] }, "parliamentary": { ... } }

GET/api/v1/local-government?district=colombo&type=MC

Local government directory

Filter MC, UC, and PS bodies by district, type, or search query.

{ "totalCount": 327, "count": 1, "bodies": [{ "id": "...", "type": "MC" }] }

GET/api/v1/transport?district=colombo

Transport directory

Bus routes, railway stations, and airports filterable by district.

{ "busRoutes": [...], "railwayStations": [...], "airports": [...] }

GET/api/v1/cost-of-living

Cost of living index

District composite index from fuel, property, and food basket seeds.

{ "nationalIndex": 72, "districts": [{ "slug": "colombo", "index": 98 }] }

GET/api/v1/vehicles

Vehicle market snapshot

District median used-vehicle prices, popular makes, and listing counts.

{ "totalListings": 112609, "districts": [{ "slug": "colombo", "medianPriceLkr": 9314924 }] }

GET/api/v1/food

Food price snapshot

Staple prices, essentials basket, and district meal-cost bands.

{ "essentialsBasketLkr": 8650, "stapleItems": [{ "name": "Rice", "priceLkr": 320 }] }

GET/api/v1/life

Life platform overview

Unified living-cost domain health from the Ariva Life Platform orchestrator.

{ "headline": "...", "domains": [{ "key": "food", "status": "degraded" }] }

GET/api/v1/export/districts

Export districts GeoJSON

Download simplified district boundaries, including CSV.

GeoJSON FeatureCollection download; add ?format=csv for CSV

GET/api/v1/export/elections

Export elections

Download presidential and parliamentary 2024 seed datasets as JSON or CSV.

{ "presidential": {...}, "parliamentary": {...} }; add ?format=csv for CSV

GET/api/v1/export/services

Export services

Download the full public services directory seed as JSON or CSV.

{ "facilities": [...], "sourceId": "public_services_seed" }; add ?format=csv for CSV

GET/api/v1/export/fuel-history?format=csv

Export fuel history

Download petrol and diesel price history as JSON or CSV.

fuelType,label,recordedAt,priceLkr,...

GET/api/v1/environment/land-change

Land Change Pulse

District greenery and built-up indices (2018→2024) with national deltas and top movers.

{ "national": { "greeneryDelta": -4 }, "districts": [...], "provenancePath": "/sources/lankawa_land_pulse" }

GET/api/v1/economy/debt

Foreign debt composition

Commercial vs concessionary external debt share series (2004–2020), normalized for Lankawa.

{ "latest": { "year": 2020, "commercialPct": 53.8 }, "series": [...], "provenancePath": "/sources/lankawa_debt_pulse" }

GET/api/v1/economy/ncpi

NCPI inflation

Latest NCPI headline YoY/MoM, core, food/non-food splits, and recent monthly series from DCS.

{ "periodLabel": "March 2026", "latest": { "yoyPct": 2.4, "momPct": 0.7 }, "provenancePath": "/sources/dcs_ncpi" }

GET/api/v1/economy/market-fx

சந்தை நடு USD/LKR

fawazahmed0 currency-api அதிகாரப்பூர்வமற்ற சந்தை நடு USD→LKR; upstream தோல்வியில் null.

{ "usdLkr": 336.63, "asOf": "2026-07-22T12:00:00.000Z", "sourceId": "market_fx_fawaz", "provenancePath": "/sources/market_fx_fawaz" }

GET/api/v1/economy/world-bank

உலக வங்கி WDI — இலங்கை

LKA-க்கான GDP வளர்ச்சி, CPI பணவீக்கம், மற்றும் மக்கள் தொகை; அனைத்தும் தோல்வியில் null.

{ "country": "LKA", "indicators": [{ "id": "gdp_growth", "value": 5.0, "year": "2024" }], "provenancePath": "/sources/world_bank_lka" }

GET/api/v1/holidays

இலங்கை அரசு விடுமுறைகள்

CBSL வங்கி/பொது விடுமுறை seed (விருப்ப year query). 2026 Gazette Extraordinary 2438/22.

{ "snapshot": { "year": 2026, "holidays": [{ "date": "2026-02-04", "nameEn": "Independence Day" }] }, "provenancePath": "/sources/lk_public_holidays" }

GET/api/v1/geocode/reverse?lat=6.93&lon=79.85

Reverse geocode

ஒரு lat/lon pin-க்கு Nominatim reverse லேபிள். நிமிடத்திற்கு 10 கோரிக்கைகள் வரை.

{ "approx": "6.93, 79.85", "place": { "displayName": "Fort, Colombo, …" }, "provenancePath": "/sources/nominatim_osm" }

GET/api/v1/economy/tariffs

PUCSL domestic tariffs

Residential electricity energy and fixed charges by consumption block with effective date.

{ "effectiveFrom": "2025-06-12", "tracks": [{ "id": "above_60", "slabs": [...] }], "provenancePath": "/sources/pucsl_tariff" }

GET/api/v1/economy/water-bill?units=20

NWSDB water bill estimate

Domestic/Samurdhi water tariff slabs with seed estimate and optional live BillCalculator totals.

{ "seedEstimate": { "totalLkr": 2537 }, "liveAvailable": true, "provenancePath": "/sources/nwsdb_tariff" }

GET/api/v1/cse/quotes?symbols=JKH.N0000,COMB.N0000

CSE per-symbol quotes

Company quotes from cse.lk companyInfoSummery for a comma-separated symbol list, with seed fallback.

{ "generatedAt": "...", "quotes": [{ "symbol": "JKH.N0000", "price": 22.1 }], "provenancePath": "/sources/cse_lk" }

GET/api/v1/cse/announcements?symbols=JKH.N0000

CSE பங்கு அறிவிப்புகள்

கோரப்பட்ட பங்குகளுக்கு cse.lk getAnnouncementByCompany இலிருந்து கடந்த ~90 நாட்களின் நிறுவன அறிவிப்புகள்.

{ "generatedAt": "...", "announcements": { "JKH.N0000": [{ "title": "DEALINGS BY DIRECTORS", "publishedAt": "..." }] }, "provenancePath": "/sources/cse_lk" }

GET/api/v1/export/land-change?format=csv

Export land change

Download district greenery and built-up indices as JSON or CSV.

slug,greenery2018,greenery2024,greeneryDelta,...

GET/api/v1/export/foreign-debt?format=csv

Export foreign debt composition

Download commercial vs concessionary debt share series as JSON or CSV.

year,commercialPct,concessionaryPct,...

GET/api/v1/export/census-living-conditions?format=csv

Export Census 2024 living conditions

Per-district households, clean cooking, pipe-borne water, improved sanitation and grid electricity shares from the DCS Census 2024 Final Report.

slug,households,cleanCookingPct,pipeBorneWaterPct,improvedSanitationPct,gridElectricityPct

GET/api/v1/export/census-age-structure?format=csv

Export Census 2024 age structure

Per-district children, working-age and senior shares plus dependency ratio from the DCS Census 2024 Final Report.

slug,population,childrenSharePct,workingAgeSharePct,ageingSharePct,dependencyRatio

GET/api/v1/disaster/landslide

Landslide early warning

District watch/warning from lk_dmc tip layout parse, with seed honesty when unavailable.

{ "watchCount": 5, "warningCount": 0, "districts": [...], "isSeed": true }

GET/api/v1/changes

Product changelog

Curated Lankawa surface changelog entries.

{ "count": 4, "entries": [{ "date": "2026-07-19", "title": "..." }] }

POST/api/v1/subscribe

Morning brief subscribe

Double opt-in email subscription for the cached morning brief.

{ "ok": true, "message": "Check your email to confirm the morning brief." }

GET/api/v1/openapi.json

OpenAPI specification

பொது API-க்கான machine-readable OpenAPI 3.1 document.

{ "openapi": "3.1.0", "info": { ... }, "paths": { ... } }

GET/api/v1/status

Platform status

Database connectivity, source freshness counts, API version, மற்றும் ingest schedule.

{ "version": "0.8.0", "database": { "configured": true, "connected": true }, "sources": { "fresh": 3 } }

GET/api/v1/pulse/history

Pulse history

Stored pulse snapshots for the last 30 days (database தேவை).

{ "days": 30, "count": 42, "snapshots": [...] }

POST/api/v1/assistant

Civic assistant

POST a question; receive an answer grounded on Lankawa API data with citations.

{ "question": "USD rate?", "answer": "...", "citations": [...], "mode": "rule" }

தரவு மூலம்

ஒவ்வொரு அளவீடும் source ID மற்றும் உள்ளக மூல பாதையை reference செய்கிறது. முறைமை மற்றும் புதுமையைப் புரிந்துகொள்ள மூல registry-ஐப் பயன்படுத்துங்கள்.

தரவு மூலங்களை உலாவு

OpenAPI document

லங்காவாவ තුළ render செய்யப்பட்ட முழு OpenAPI specification-ஐப் பார்க்கவும், அல்லது API-யிலிருந்து raw JSON fetch செய்யவும்.

OpenAPI JSON பார்க்க