> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Weather Forecast

> Hourly, daily and current weather forecast for any coordinate, up to 16 days ahead.

Fetch a weather forecast for any WGS84 coordinate from Open-Meteo's blended high-resolution model mix. Choose the fields you want with `hourly`, `daily` and `current` (comma-separated variable lists) — e.g. `temperature_2m`, `precipitation`, `wind_speed_10m` for hourly, or `temperature_2m_max`/`precipitation_sum` for daily. Control the horizon with `forecast_days` (up to 16) and `past_days`, and set `timezone=auto` to localize daily aggregates.

The response returns the resolved grid-cell `latitude`/`longitude`/`elevation`, `timezone` metadata, and a block per requested resolution (`hourly`, `daily`, `current`) each with a parallel `time` array plus one array per variable, alongside a matching `*_units` object.

Example: `GET /apis/v1/openmeteo/forecast?latitude=52.52&longitude=13.41&hourly=temperature_2m,precipitation&daily=temperature_2m_max,temperature_2m_min&current=temperature_2m,weather_code&timezone=Europe/Berlin`.

**Billing: \$0.00015 per call (150 micros USD), metered per request.** All Open-Meteo endpoints are GET pass-through — authenticate with your AIsa API key as a bearer token (the same key used across every AIsa `/apis/*` endpoint); AIsa handles provider access.


## OpenAPI

````yaml openapi/openmeteo.json GET /openmeteo/forecast
openapi: 3.0.3
info:
  title: Open-Meteo Weather API
  version: 1.0.0
  description: >-
    Open-Meteo weather data routed through the AIsa gateway: forecast,
    historical, air quality, marine, ensemble, seasonal, climate, flood,
    geocoding and elevation. All endpoints are GET pass-through to Open-Meteo
    (open-meteo.com); AIsa handles provider access. Flat pricing of $0.00015 per
    call (150 micros USD), metered per request.
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - BearerAuth: []
paths:
  /openmeteo/forecast:
    get:
      summary: Weather Forecast
      description: >-
        Hourly, daily and current weather forecast for any WGS84 coordinate, up
        to 16 days ahead, from Open-Meteo's blended high-resolution model mix.
        Select the variables you need with the `hourly`, `daily` and `current`
        parameters. GET pass-through to
        `https://api.open-meteo.com/v1/forecast`.


        Billed $0.00015 per call, metered per request.
      operationId: get_openmeteo_forecast
      parameters:
        - name: latitude
          in: query
          required: true
          description: >-
            WGS84 latitude of the location. Multiple coordinates can be
            comma-separated.
          schema:
            type: string
            example: '52.52'
        - name: longitude
          in: query
          required: true
          description: >-
            WGS84 longitude of the location (negative for the Americas).
            Multiple coordinates can be comma-separated.
          schema:
            type: string
            example: '13.41'
        - name: hourly
          in: query
          required: false
          description: >-
            Comma-separated list of hourly variables to return. Common values:
            `temperature_2m`, `relative_humidity_2m`, `dew_point_2m`,
            `apparent_temperature`, `precipitation`, `rain`, `showers`,
            `snowfall`, `weather_code`, `pressure_msl`, `cloud_cover`,
            `wind_speed_10m`, `wind_direction_10m`, `wind_gusts_10m`,
            `shortwave_radiation`, `visibility`.
          schema:
            type: string
            example: temperature_2m,precipitation,wind_speed_10m
        - name: daily
          in: query
          required: false
          description: >-
            Comma-separated list of daily aggregation variables to return.
            Requires `timezone`. Common values: `temperature_2m_max`,
            `temperature_2m_min`, `temperature_2m_mean`, `precipitation_sum`,
            `rain_sum`, `snowfall_sum`, `weather_code`, `sunrise`, `sunset`,
            `sunshine_duration`, `wind_speed_10m_max`, `uv_index_max`.
          schema:
            type: string
            example: temperature_2m_max,temperature_2m_min,precipitation_sum
        - name: current
          in: query
          required: false
          description: >-
            Comma-separated list of current-condition variables to return.
            Common values: `temperature_2m`, `relative_humidity_2m`,
            `apparent_temperature`, `is_day`, `precipitation`, `weather_code`,
            `wind_speed_10m`, `wind_direction_10m`.
          schema:
            type: string
            example: temperature_2m,weather_code
        - name: minutely_15
          in: query
          required: false
          description: >-
            Comma-separated 15-minutely variables (Central Europe & North
            America high-resolution models only).
          schema:
            type: string
            example: temperature_2m,precipitation
        - name: forecast_days
          in: query
          required: false
          description: Number of forecast days to return (0-16). Default 7.
          schema:
            type: integer
            default: 7
            example: 7
        - name: past_days
          in: query
          required: false
          description: Number of past days to include (0-92). Default 0.
          schema:
            type: integer
            default: 0
        - name: forecast_hours
          in: query
          required: false
          description: Limit the forecast to a given number of hours from now.
          schema:
            type: integer
        - name: past_hours
          in: query
          required: false
          description: Include a given number of past hours.
          schema:
            type: integer
        - name: start_date
          in: query
          required: false
          description: Start of the interval, `yyyy-mm-dd` (ISO 8601).
          schema:
            type: string
            example: '2024-01-01'
            format: date
        - name: end_date
          in: query
          required: false
          description: End of the interval, `yyyy-mm-dd` (ISO 8601).
          schema:
            type: string
            example: '2024-01-07'
            format: date
        - name: elevation
          in: query
          required: false
          description: >-
            Manual elevation (meters) for statistical downscaling. Defaults to a
            90m DEM. Use `nan` to disable downscaling.
          schema:
            type: string
            example: '38'
        - name: temperature_unit
          in: query
          required: false
          description: Temperature unit. Default `celsius`.
          schema:
            type: string
            enum:
              - celsius
              - fahrenheit
            default: celsius
        - name: wind_speed_unit
          in: query
          required: false
          description: Wind speed unit. Default `kmh`.
          schema:
            type: string
            enum:
              - kmh
              - ms
              - mph
              - kn
            default: kmh
        - name: precipitation_unit
          in: query
          required: false
          description: Precipitation unit. Default `mm`.
          schema:
            type: string
            enum:
              - mm
              - inch
            default: mm
        - name: timeformat
          in: query
          required: false
          description: Time output format. Default `iso8601`.
          schema:
            type: string
            enum:
              - iso8601
              - unixtime
            default: iso8601
        - name: models
          in: query
          required: false
          description: >-
            Comma-separated forecast models to use. Default `auto` selects the
            best model mix per location.
          schema:
            type: string
            example: auto
        - name: timezone
          in: query
          required: false
          description: >-
            IANA time zone name (e.g. `Europe/Berlin`) or `auto` to resolve from
            coordinates. Defaults to `GMT`.
          schema:
            type: string
            example: Europe/Berlin
        - name: cell_selection
          in: query
          required: false
          description: Grid-cell preference for the coordinate. Default `land`.
          schema:
            type: string
            enum:
              - land
              - sea
              - nearest
            default: land
      responses:
        '200':
          description: Requested weather forecast for the coordinate.
          content:
            application/json:
              schema:
                type: object
              example:
                latitude: 52.52
                longitude: 13.419998
                generationtime_ms: 0.19
                utc_offset_seconds: 7200
                timezone: Europe/Berlin
                timezone_abbreviation: CEST
                elevation: 38
                current_units:
                  time: iso8601
                  interval: seconds
                  temperature_2m: °C
                  weather_code: wmo code
                current:
                  time: 2024-01-01T12:00
                  interval: 900
                  temperature_2m: 4.5
                  weather_code: 3
                hourly_units:
                  time: iso8601
                  temperature_2m: °C
                  precipitation: mm
                  wind_speed_10m: km/h
                hourly:
                  time:
                    - 2024-01-01T00:00
                    - 2024-01-01T01:00
                  temperature_2m:
                    - 2.1
                    - 1.9
                  precipitation:
                    - 0
                    - 0.1
                  wind_speed_10m:
                    - 11.2
                    - 10.4
                daily_units:
                  time: iso8601
                  temperature_2m_max: °C
                  temperature_2m_min: °C
                  precipitation_sum: mm
                daily:
                  time:
                    - '2024-01-01'
                  temperature_2m_max:
                    - 5.2
                  temperature_2m_min:
                    - 1.1
                  precipitation_sum:
                    - 0.4
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: AISA API Key

````