openapi: 3.0.1
info:
  title: Weatherbit - Interactive Swagger UI Documentation 16 Day / Daily Forecast AgWeather Forecast API
  description: This an interactive version of the documentation for the Weatherbit API.  The base URL for the API is [http://api.weatherbit.io/v2.0/](http://api.weatherbit.io/v2.0/) or [https://api.weatherbit.io/v2.0/](http://api.weatherbit.io/v2.0/). Below is the Swagger UI documentation for the API. All API requests require the `key` parameter.        An Example for a 48 hour forecast for London, UK would be `http://api.weatherbit.io/v2.0/forecast/hourly?lat=51.5072`&`lon=-0.1276`. See our [Weather API description page](https://www.weatherbit.io/api) for the full documentation.
  version: 2.0.0
servers:
- url: https://api.weatherbit.io/v2.0
- url: http://api.weatherbit.io/v2.0
tags:
- name: AgWeather Forecast
paths:
  /forecast/agweather:
    get:
      tags:
      - AgWeather Forecast
      summary: Weatherbit Returns Agweather Forecast - Given a Lat/lon.
      description: Returns Agweather Forecast  - Given a lat, and lon. See https://www.weatherbit.io/api for API specific rate limits.
      parameters:
      - name: lat
        in: query
        description: Latitude component of location.
        schema:
          type: number
          format: double
        example: 34.18
      - name: lon
        in: query
        description: Longitude component of location.
        schema:
          type: number
          format: double
        example: 56.54
      - name: start_date
        in: query
        description: Start Date (YYYY-MM-DD or YYYY-MM-DD:HH).
        required: true
        schema:
          type: string
          format: string
        example: example-value
      - name: end_date
        in: query
        description: End Date (YYYY-MM-DD or YYYY-MM-DD:HH).
        required: true
        schema:
          type: string
          format: string
        example: example-value
      - name: units
        in: query
        description: Convert to units. Default Metric See <a target='blank' href='/api/requests'>units field description</a>
        schema:
          type: string
          format: string
          enum:
          - S
          - I
        example: I
      - name: key
        in: query
        description: Your registered API key.
        required: true
        schema:
          type: string
          format: string
        example: abc123xyz
      responses:
        '200':
          description: An AGWeather Forecast Data Object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForecastAG'
        default:
          description: No Data.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    ForecastAG:
      type: object
      properties:
        lat:
          type: number
          description: Latitude
          example: 47.61
        lon:
          type: number
          description: Longitude
          example: -122.33
        data:
          type: array
          items:
            $ref: '#/components/schemas/HistoryAGObj'
    Error:
      type: object
      properties:
        code:
          type: integer
          format: int32
        message:
          type: string
    HistoryAGObj:
      type: object
      properties:
        bulk_soil_density:
          type: number
          description: Bulk Soil Density
          example: 1370.0
        dlwrf_avg:
          type: number
          description: Average Downward Longwave Radiation Flux
          example: 418.656
        dlwrf_max:
          type: number
          description: Maximum Downward Longwave Radiation Flux
          example: 440.25
        dlwrf_net:
          type: number
          description: Net Downward Longwave Radiation Flux
          example: 143.0
        dswrf_avg:
          type: number
          description: Average Downward Shortwave Radiation Flux
          example: 158.848
        dswrf_max:
          type: number
          description: Maximum Downward Shortwave Radiation Flux
          example: 492.25
        dswrf_net:
          type: number
          description: Net Downward Shortwave Radiation Flux
          example: -50.832
        evapotranspiration:
          type: number
          description: Evapotranspiration
          example: 4.247
        precip:
          type: number
          description: Precipitation
          example: 18.5
        pres_avg:
          type: number
          description: Average Pressure
          example: 1011.644
        revision_status:
          type: string
          description: Data revision status
          example: final
        skin_temp_avg:
          type: number
          description: Average Skin Temperature
          example: 29.4
        skin_temp_max:
          type: number
          description: Maximum Skin Temperature
          example: 40.4
        skin_temp_min:
          type: number
          description: Minimum Skin Temperature
          example: 25.4
        soilm_0_10cm:
          type: number
          description: Soil Moisture (0-10cm depth)
          example: 25.697
        soilm_100_200cm:
          type: number
          description: Soil Moisture (100-200cm depth)
          example: 273.625
        soilm_10_40cm:
          type: number
          description: Soil Moisture (10-40cm depth)
          example: 72.813
        soilm_40_100cm:
          type: number
          description: Soil Moisture (40-100cm depth)
          example: 152.203
        soilt_0_10cm:
          type: number
          description: Soil Temperature (0-10cm depth)
          example: 29.5
        soilt_100_200cm:
          type: number
          description: Soil Temperature (100-200cm depth)
          example: 24.4
        soilt_10_40cm:
          type: number
          description: Soil Temperature (10-40cm depth)
          example: 29.8
        soilt_40_100cm:
          type: number
          description: Soil Temperature (40-100cm depth)
          example: 27.7
        specific_humidity:
          type: number
          description: Specific Humidity
          example: 0.014513969421387
        timestamp_local:
          type: string
          description: Timestamp in local time
          example: 2023-09-08 00:00:00
        timestamp_utc:
          type: string
          description: Timestamp UTC
          example: 2023-09-08 00:00:00
        temp_2m_avg:
          type: number
          description: Average Temperature at 2 meters
          example: 26.6
        v_soilm_0_10cm:
          type: number
          description: Volumetric Soil Moisture (0-10cm depth)
          example: 0.257
        v_soilm_100_200cm:
          type: number
          description: Volumetric Soil Moisture (100-200cm depth)
          example: 0.274
        v_soilm_10_40cm:
          type: number
          description: Volumetric Soil Moisture (10-40cm depth)
          example: 0.243
        v_soilm_40_100cm:
          type: number
          description: Volumetric Soil Moisture (40-100cm depth)
          example: 0.254
        valid_date:
          type: string
          description: Valid Date
          example: 2023-09-08
        wind_10m_spd_avg:
          type: number
          description: Average Wind Speed at 10 meters
          example: 2.505