# Provenance stamped 2026-10-07 (roadmap#943): written by an API Evangelist sweep (dated 2026-05-29 by the file itself), not
# harvested from the provider. `method: generated` so the economics campaign may replace it with a
# dated, verbatim transcription; every figure below is unverified until it does.
# Coverage demoted 2026-10-07 (roadmap#942, PLAN.md Stage A): this file was written by an API Evangelist
# sweep and names no billing unit, meters or pricing category read from the provider — it restates the
# FinOps framework. It is `x-coverage: unmeasured`, and the FOCUS alignment it claimed has been removed.
x-coverage: unmeasured
method: generated
generated: '2026-05-29'
specification: FinOps Framework
specificationVersion: '1.0'
provider: OpenWeatherMap
providerId: openweathermap
publisherName: OpenWeather Ltd
serviceCategory: API
created: '2026-05-29'
modified: '2026-05-29'
tags:
  - Weather
  - Forecast
  - Air Pollution
  - Solar
  - FinOps
  - Cost Management
  - FOCUS
description: FinOps definition for the OpenWeather API surface. Provides a FOCUS-aligned mapping for cost allocation, usage measurement, and unit-economics reporting across the API portfolio. Supports both subscription and pay-per-call pricing models.
principles:
  - name: Visibility
    description: Expose API consumption and cost to engineering, product, and finance teams in near real time.
  - name: Allocation
    description: Tag every chargeable API call with consuming team, environment, application, and feature so cost can be allocated.
  - name: Optimization
    description: Evaluate request patterns, caching, batching, and tier selection to reduce cost per useful unit of work.
  - name: Accountability
    description: Establish budget owners and chargeback or showback flows for each consuming team.
domains:
  - name: Understand Usage and Cost
    capabilities:
      - Data Ingestion
      - Allocation
      - Reporting and Analytics
      - Anomaly Management
  - name: Quantify Business Value
    capabilities:
      - Planning and Estimating
      - Forecasting
      - Budgeting
      - Benchmarking
      - Unit Economics
  - name: Optimize Usage and Cost
    capabilities:
      - Architecting for Cloud
      - Rate Optimization
      - Workload Optimization
      - Licensing and SaaS
  - name: Manage the FinOps Practice
    capabilities:
      - FinOps Practice Operations
      - FinOps Education and Enablement
      - Invoicing and Chargeback
      - Onboarding Workloads
billingModel:
  pricingCategory: Usage-Based
  billingFrequency: Monthly
  billingCurrency: USD
  chargeCategories:
    - Usage
    - Purchase
    - Tax
    - Credit
    - Adjustment
  chargeFrequency: Recurring
focusColumns:
  ServiceName: OpenWeatherMap
  ServiceCategory: Developer Tools / Weather Data API
  ProviderName: OpenWeather Ltd
  PublisherName: OpenWeather Ltd
  InvoiceIssuerName: OpenWeather Ltd
  PricingCategory: Usage-Based
  PricingUnit: request
  BillingCurrency: USD
  ChargeCategory: Usage
meters:
  - name: api_requests
    description: Count of billable API requests across all OpenWeather APIs.
    unit: request
    aggregation: sum
    dimensions:
      - api
      - endpoint
      - tier
      - region
      - consumer
  - name: one_call_requests
    description: Count of One Call 4.0 requests, used to evaluate the daily free allotment and bill overage.
    unit: request
    aggregation: sum
    dimensions:
      - tier
      - consumer
  - name: data_egress
    description: Bytes returned over the network in API responses, useful for high-volume bulk and tile traffic.
    unit: GB
    aggregation: sum
    dimensions:
      - api
      - region
      - consumer
  - name: bulk_files
    description: Count of bulk file downloads (Bulk Current Data, History Bulk, Solar Bulks).
    unit: file
    aggregation: sum
    dimensions:
      - product
      - period
      - consumer
apis:
  - name: Current Weather Data API
    baseURL: https://api.openweathermap.org/data/2.5
    tags: [Weather]
    serviceName: Current Weather Data
    serviceCategory: API
  - name: 5-day / 3-hour Forecast API
    baseURL: https://api.openweathermap.org/data/2.5
    tags: [Forecast]
    serviceName: 5-day Forecast
    serviceCategory: API
  - name: Hourly Forecast 4 Days
    baseURL: https://pro.openweathermap.org/data/2.5
    tags: [Forecast]
    serviceName: Hourly Forecast
    serviceCategory: API
  - name: Daily Forecast 16 Days
    baseURL: https://pro.openweathermap.org/data/2.5
    tags: [Forecast]
    serviceName: Daily Forecast
    serviceCategory: API
  - name: Climatic Forecast 30 Days
    baseURL: https://pro.openweathermap.org/data/2.5
    tags: [Forecast, Climate]
    serviceName: Climatic Forecast
    serviceCategory: API
  - name: One Call API 4.0
    baseURL: https://api.openweathermap.org/data/4.0/onecall
    tags: [Weather, Forecast, History]
    serviceName: One Call 4.0
    serviceCategory: API
  - name: Air Pollution API
    baseURL: https://api.openweathermap.org/data/2.5
    tags: [Air Pollution, Air Quality]
    serviceName: Air Pollution
    serviceCategory: API
  - name: Geocoding API
    baseURL: https://api.openweathermap.org/geo/1.0
    tags: [Geocoding]
    serviceName: Geocoding
    serviceCategory: API
  - name: Historical Weather API
    baseURL: https://history.openweathermap.org/data/2.5
    tags: [History]
    serviceName: Historical Weather
    serviceCategory: API
  - name: Statistical Weather Data API
    baseURL: https://history.openweathermap.org/data/2.5
    tags: [Climate, Statistics]
    serviceName: Statistical Weather
    serviceCategory: API
  - name: Accumulated Parameters API
    baseURL: https://history.openweathermap.org/data/2.5/history
    tags: [Agriculture, History]
    serviceName: Accumulated Parameters
    serviceCategory: API
  - name: Road Risk API
    baseURL: https://api.openweathermap.org
    tags: [Routing, Risk]
    serviceName: Road Risk
    serviceCategory: API
  - name: Solar Irradiance API
    baseURL: https://api.openweathermap.org/energy/2.0
    tags: [Solar]
    serviceName: Solar Irradiance
    serviceCategory: API
  - name: Solar Panel Energy Prediction API
    baseURL: https://api.openweathermap.org/energy/2.0
    tags: [Solar, Energy]
    serviceName: Solar Panel Energy
    serviceCategory: API
  - name: Weather Stations API
    baseURL: https://api.openweathermap.org/data/3.0
    tags: [Stations, IoT]
    serviceName: Weather Stations
    serviceCategory: API
  - name: Weather Maps 1.0
    baseURL: https://tile.openweathermap.org
    tags: [Maps, Tiles]
    serviceName: Weather Maps
    serviceCategory: API
unitEconomics:
  - name: Cost per 1K Requests
    metric: billed_cost / (api_requests / 1000)
  - name: Cost per Active Consumer
    metric: billed_cost / active_consumers
  - name: One Call Free Allotment Utilization
    metric: one_call_requests_within_free_window / 1000
  - name: Cost per Forecast Refresh
    metric: billed_cost / forecast_refresh_count
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com