Reference · built on requestCommons signalWeather & climate

IMD API Portal

India Meteorological Department forecasts, nowcasts, district warnings, rainfall, marine and cyclone products via api.imd.gov.in.

Request accessPricing ↗

About

The India Meteorological Department runs an API management portal at api.imd.gov.in for its observation, forecast and warning products. Its reference lists JSON endpoints under /api/v1: seven-day city forecasts, current weather, district and station nowcasts, AWS and ARG observations, district and subdivision warnings, district and state rainfall, river basin QPF, port warnings, sea area and coastal bulletins, cyclone track, wind warning and cone of uncertainty, and sun and moon times. Calls without an API key return 401. Alerts are also published as a CAP RSS feed.

Through Fibric, an operator reads the warnings and nowcasts for the districts you operate in and proposes a dispatch hold, a crew notice, or a site preparation for your approval.

This is a reference listing. It documents what Fibric would read from IMD API Portal and what it could propose, based on the publisher's published interfaces. Fibric builds it under a managed deployment when you request it; selecting it here installs nothing.

Inputs

  • City weather forecast for seven days through /api/v1/cityforecast and cityforecastloc, with observed maxima, minima and rainfall
  • Current weather through /api/v1/current_wx: MSLP, wind, temperature, weather code, nebulosity, humidity and 24-hour rainfall
  • District-wise and station-wise nowcasts with category codes, message text, time of issue and valid-upto time
  • District-wise warnings for five days with codes such as heavy rain, heat wave, cold wave and fog, and a colour per day
  • District and state rainfall with daily, weekly, monthly and cumulative actuals, normals and departure categories
  • AWS/ARG station data by call sign or state id through /api/v1/aws_data
  • Marine and cyclone products: port warnings, sea area and coastal bulletins, cyclone track, wind warning polygons and cone of uncertainty

Proposed actions

Read-only. This feed informs operators; it changes nothing.

Proposed actions are target capabilities. Every action runs propose-first and needs a validated deployment and the appropriate permissions.

What you can build

  • Hold dispatch into a red-warning district

    Read districtwarning for the districts on today's routes and propose a hold or a later ETA notice when a day carries a red or orange colour code.

    With Weather Hold, ETA Notice

  • Warn field crews about a heat wave

    When a district warning carries code 9 (heat wave) or 10 (hot day), propose a notice to lone workers and supervisors with the valid days.

    With Lone Worker, Severe Weather Notice

  • Prepare coastal sites for a cyclone

    Read cyclone_track, cyclone_wind and portwarning, match the polygons to your sites, and propose the preparation checklist for each.

    With Storm Prep

Requirements

  • An account on api.imd.gov.in created with name, email and password behind a CAPTCHA, then confirmed by email
  • For government organisations, an email on gov.in, nic.in, cdot.in, cdac.in, nhai.org or icar.org.in
  • Station, district, state, port or basin ids taken from mapping endpoints such as cityforecast_mapping and aws_data_mapping
  • Agreement to IMD's terms and conditions, arranged with IMD's nodal officer for organisational use
Authentication
An API key tied to an IMD API portal account; calls without one return HTTP 401 with the message API key missing.

Limits

  • No rate limits, quotas or plan tiers are published on the portal
  • The data license is not stated on the portal; IMD's notice directs organisations to its nodal officer for terms
  • Field spelling varies between endpoints, for example Departue and Acutual in sample rainfall records
  • Colour codes are numbered differently in the nowcast and district warning endpoints

Access and pricing

Reference listing. Public feed access is separate from Fibric integration. If you request this feed, your quote covers the build, usage, and support.

Request IMD API Portal ↗

Questions and answers

Is a key required to call the IMD endpoints?
Yes. A request to /api/v1/current_wx without a key returns HTTP 401 and the message API key missing. Keys come with an account on api.imd.gov.in, which describes key-based API consumption after profile validation.
Where do the CAP alerts come from?
IMD's Mausam site links an RSS feed of CAP alerts at cap-sources.s3.amazonaws.com/in-imd-en/rss.xml. Each item links to a CAP XML file, and the channel is marked public domain.
How far ahead do the forecasts and warnings go?
City forecasts cover seven days. District warnings and river basin QPF cover five days. Subdivision rainfall forecasts cover seven days and state district rainfall forecasts five. Nowcasts carry a time of issue and a valid-upto time.
Ask about IMD API Portal

Ask about the capabilities and requirements in this listing.

For project-specific requirements, contact Fibric.

This Commons signal listing is developed, published, and supported by Fibric. It reads public data published by India Meteorological Department (api.imd.gov.in). Upstream agencies and projects are the property of their respective owners, who are not affiliated with Fibric and do not sponsor or endorse this listing. Trademark policy