API Reference
Smart Island API
v1.0.0OpenAPI 3.1REST API and MCP server for the Isle of Man data platform. 30+ datasets covering jobs, vehicles, property, aircraft, crime, companies, biosphere, marine, IoT, telecoms, and more - all freely accessible. Job vacancies are enriched with SOC2020 classification, O*NET skills, automation risk, and AI exposure scores. No API key required.
Base URL
https://smartisland.im
All endpoints return JSON. No authentication required for read operations.
Endpoints
Jobs
GET/api/jobsJobs
List / search active vacancies
Paginated job listings with full-text search and filters: category, area, hours type, contract type, automation risk level, salary range, employer type, and new within N days. Returns live enrichment data including skills, SOC2020 code, and risk scores.
GET/api/jobs/{id}Jobs
Full job detail with AI enrichment
Complete vacancy record including description, closing date, application URL, and the full AI enrichment panel: skills, tasks, knowledge areas, automation risk score, AIOE score, alternative career paths, and related roles.
GET/api/jobs/{id}/fluencyJobsAI
AI Fluency rubric for a job's occupation
Returns a Zapier-inspired AI Fluency matrix for the occupation associated with a job. Covers five proficiency levels (Aware, Explorer, Operator, Integrator, Innovator) across key competency dimensions, with role-specific guidance and progression milestones.
Skills
GET/api/skills/registrySkills
Browse canonical skill registry
Returns the full normalised skill taxonomy used by the enrichment pipeline. Use these exact skill names as filter values when querying jobs. Supports search and pagination.
Trends
GET/api/trends/snapshotsTrends
Weekly market snapshot time series
Historical weekly snapshots captured every Sunday. Each snapshot records total vacancies, risk averages, new and disappeared jobs, top skills, top categories, and area breakdowns. Use for trend analysis and week-on-week comparisons.
GET/api/trends/snapshots/{week}Trends
Single weekly snapshot detail
Retrieve a specific week's market snapshot by ISO week label (e.g. 2026-W11). Returns the full breakdown including salary distributions, automation risk histogram, and sector analysis.
Vehicles
GET/api/vehicles/statsVehicles
Vehicle fleet summary statistics
Returns total vehicles, fuel breakdown, EV share, top makes, and fleet composition from the IoM vehicle registry (~76,000 active vehicles).
Aircraft
GET/api/aircraftAircraft
Search the IoM Aircraft Register
Search aircraft by manufacturer, type, or registration mark. Query params: q (search term), status (Registered|Deregistered|all, default Registered), limit (max 50).
GET/api/aircraft/statsAircraft
Aircraft registry summary statistics
Returns total registered/deregistered counts, top 10 manufacturers, and top 10 aircraft types from the IoM Aircraft Register.
Property
GET/api/propertyProperty
Search IoM land transactions
Search the Land Registry by town, parish, price range, and year. Query params: town, parish, minPrice, maxPrice, year, limit (max 50). Returns property address, sale price, and acquisition date.
GET/api/property/statsProperty
Property market summary statistics
IoM property market summary for a given year (default: previous year). Returns total transactions, average/median price, top towns by volume, and parish breakdown. Query param: year.
Planning
GET/api/planningPlanning
Search planning applications
Search 80,000+ IoM planning applications by parish, application type, year, and keyword. Returns application reference, address, description, decision, and dates. Query params: q, parish, type, year, status, limit (max 200), offset.
Crime
GET/api/crime/statsCrime
Crime statistics summary
IoM crime statistics for a financial year (e.g. 2024-25). Returns total recorded crime, detection rate, crime per 1000 population, category breakdown, and comparisons with UK jurisdictions. Query param: year (omit for latest).
GET/api/crime/trendsCrime
Crime trend data
Historical crime trends across all available years: total recorded crime, category breakdown over time, and comparative trend (IoM vs England & Wales, Jersey, Guernsey). Optional query param: category.
Companies
GET/api/companiesCompanies
Search companies registry
Search the IoM Companies Registry by name, registry type, or status. Returns company number, name, incorporation date, status, registry type, and registered address. Query params: search, type, status, limit (max 200).
GET/api/companies/statsCompanies
Companies registry summary
Aggregate statistics: total entities, live vs dissolved breakdown, counts by registry type and status, peak incorporation year.
Financial Services
GET/api/financial-servicesFinancial Services
Search IOMFSA regulated entities
Search the IoM Financial Services Authority register by name, category, or licence type. Returns entity name, licence holder, category, status, and regulatory details. Query params: search, category, limit (max 200).
GET/api/financial-services/statsFinancial Services
Financial services summary statistics
Aggregate statistics: total regulated entities, breakdown by category (banks, insurers, trust companies, fund managers, etc.), active vs surrendered licences.
Gambling
GET/api/gamblingGambling
Search GSC gambling licensees
Search the IoM Gambling Supervision Commission register of online gambling licensees. Returns operator name, licence type, trading names, and status. Query params: search, type, limit (max 200).
GET/api/gambling/statsGambling
Gambling licences summary statistics
Aggregate statistics: total licensees, breakdown by licence type (full, sub, software supplier, network services), and operator status.
Ship Registry
GET/api/shipsShips
Search IoM Ship Registry
Search the IoM Ship Registry by name, vessel type, or status. Returns ship name, vessel type, IMO number, official number, and registration status. Query params: search, type, status, limit (max 200).
GET/api/ships/statsShips
Ship registry summary statistics
Aggregate statistics: total vessels, active vs closed, breakdown by vessel type and category (Merchant/Yacht/Fishing/Government), count of vessels with IMO numbers.
Weather & Climate
GET/api/weatherWeather
Current weather, 7-day forecast & marine
Live weather conditions in Douglas from Open-Meteo: temperature, wind, humidity, cloud cover, 7-day daily forecast, and marine data (wave height, period, direction). Cached for 15 minutes.
GET/api/weather/climateWeather
65 years of climate statistics
Historical climate data for Douglas (1960-present) from ERA5 reanalysis. Decade averages, all-time records, monthly temperature and rainfall profiles, frost/warm days per year, annual rainfall, warming trend with linear regression. Cached for 24 hours.
Utilities
GET/api/utilitiesUtilities
MUA utility tariff data
Manx Utilities Authority electricity, water, and sewerage tariffs with computed statistics, UK comparison data, estimated annual bills, and chart-ready data. Cached for 24 hours.
World Bank
GET/api/world-bankWorld Bank
Search World Bank indicators
Search the World Bank Development Indicators for Isle of Man by category or indicator name/code. Returns time series data for each indicator. Query params: category, indicator, limit (max 200). Cached for 24 hours.
GET/api/world-bank/statsWorld Bank
World Bank indicators summary
Aggregate statistics: total indicators, data coverage by category, key headline numbers (GDP, population, life expectancy), and most data-rich indicators.
Biosphere
GET/api/biosphere/speciesBiosphere
Search species directory
Search 15,000+ species from the pre-aggregated summary table. Supports text search, group filtering, and pagination. Query params: q, group, year, limit (max 100), offset. Returns species name, common name, group, kingdom, family, record count, year range, and dataset count. Falls back to raw 1.49M occurrence table if summary unavailable.
GET/api/biosphere/statsBiosphere
Biodiversity statistics summary
Aggregate biodiversity statistics for the Isle of Man: total records, species count, kingdom breakdown, species group distribution, top recorded species, and recording trends by decade. Cached for 1 hour.
GET/api/biosphere/observationsBiosphere
Species observation points
Returns geo-located observation points for mapping. Supports aggregate mode (groups by unique lat/lon with counts) and raw mode (individual observations). Query params: species, group, yearFrom, yearTo, aggregate, limit (max 5000).
GET/api/biosphere/emissionsBiosphereVehicles
Vehicle emissions & EV adoption
CO2 emission averages, EV adoption rates, fuel type breakdown, and fleet-wide environmental statistics derived from the IoM vehicle registry (~80,000 active vehicles). Includes make/model-level averages and imputed values.
GET/api/biosphere/tree-coverBiosphere
Hansen Global Forest Change data
Tree cover extent, loss, and gain for the Isle of Man derived from Hansen/UMD Global Forest Change satellite imagery. Returns annual loss time series, net change, and percentage cover.
GET/api/biosphere/soil-moistureBiosphere
ERA5-Land soil moisture at three depths
Soil moisture data from ERA5-Land reanalysis at three depth levels (0-7cm, 7-28cm, 28-100cm). Returns monthly time series, seasonal patterns, and long-term trends for the Isle of Man.
GET/api/biosphere/land-temperatureBiosphere
Land surface temperature trends
Land surface temperature data for the Isle of Man from satellite and reanalysis sources. Returns monthly and annual averages, warming trend analysis, and anomaly time series.
IoT
POST/api/iot/eventsIoT
IoT sensor event receiver
Generic JSON event receiver for LoRaWAN sensors. Accepts uplink payloads from the MTG IoT Network. Supports Milesight UC500/UC501 Smart Farm sensors (rainfall, solar, battery), EM300-TH (temperature/humidity), and AM307 (air quality). Auto-detects and decodes device type.
GET/api/iot/devicesIoT
List IoT devices and readings
Returns all registered IoT devices with their latest sensor readings, signal strength, battery level, and last-seen timestamp.
Election 2026
GET/api/electionsElections
Election 2026 analysis & results
Isle of Man General Election 2026 data: constituency results, candidate profiles, turnout statistics, historical comparisons, and seat-level analysis. Query params: constituency, candidate.
🤖
MCP Tools — AI Assistant Integration
An MCP (Model Context Protocol) server runs alongside the REST API, exposing 81+ structured tools that AI assistants (Claude, GPT, etc.) can call directly to query the job market, vehicle registry, aircraft register, property market, crime data, companies registry, financial services, gambling licences, ship registry, utility tariffs, World Bank indicators, biosphere species, marine data, IoT sensors, telecoms, and FOI requests without building REST calls manually.
Streamable HTTP: POST https://mcp.smartisland.im/mcp
SSE (legacy): GET https://mcp.smartisland.im/sse
lookup_occupation— Resolve job title to SOC codes
get_occupation_profile— Full occupation profile with AI exposure
list_jobs— Paginated job list with filters
get_job— Full job record + enrichment by ID
search_jobs_by_skills— Match jobs against a skill list
search_jobs_by_knowledge— Match jobs by knowledge areas
get_career_paths— Career transitions with live IOM vacancies
get_skills_gap— Skills gap analysis between two roles
get_skills_transferability— Discover where your skills are valued
get_task_breakdown— Task-level automation analysis
get_occupation_exposure_detail— Deep AI exposure from 3 indices
get_visa_eligibility— UK Skilled Worker visa check
get_salary_comparison— UK vs IoM salary comparison
get_job_market_stats— Live market overview
vehicle_search— Search IoM vehicle register
vehicle_lookup— Lookup a specific plate
vehicle_stats— Vehicle fleet statistics
aircraft_search— Search IoM Aircraft Register
aircraft_stats— Aircraft registry statistics
property_search— Search land transactions
property_stats— Property market summary
crime_stats— Crime statistics summary
crime_trends— Crime trend data over time
company_search— Search IoM Companies Registry
company_stats— Companies registry statistics
fsa_search— Search IOMFSA regulated entities
fsa_stats— Financial services statistics
gsc_search— Search GSC gambling licensees
gsc_stats— Gambling licences statistics
ship_search— Search IoM Ship Registry
ship_stats— Ship registry statistics
utility_tariffs— MUA electricity, water, sewerage tariffs
worldbank_search— Search World Bank IoM indicators
worldbank_stats— World Bank indicators summary
weather_current— Live weather, forecast & marine
weather_climate— 65 years of climate statistics
species_search— Search 15k+ IoM species
species_stats— Biodiversity statistics
species_trend— Species recording trend by year
species_by_location— Species near a coordinate
habitat_query— Habitat and conservation data
biosphere_advisor— AI biodiversity analysis
marine_search— Marine protected areas & features
subsea_cables— Submarine cable routes & history
foi_search— Search IoM FOI requests
foi_stats— FOI statistics & trends
fiu_search— Financial intelligence SARs
fiu_stats— FIU aggregate statistics
telecoms_stats— CURA broadband & mobile stats
broadband_speeds— Ookla speed data & rankings
iot_devices— Live IoT sensor readings
Test locally: npx @modelcontextprotocol/inspector https://mcp.smartisland.im/sse
Browse all 81+ tools →