Current weather snapshot

What you receive

Demonstration data only. The paid endpoint returns a fresh result and settlement receipt.

{
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "data.current-weather",
  "version": "1",
  "data": {
    "location": {
      "latitude": 38.8951,
      "longitude": -77.0364,
      "city": "Washington",
      "state": "DC",
      "timezone": "America/New_York",
      "grid": null,
      "resolvedPlace": {
        "query": "Washington, DC, US",
        "geonameId": 4140963,
        "name": "Washington",
        "countryCode": "US",
        "admin1Code": "DC",
        "candidateCount": 1,
        "ambiguous": false,
        "attribution": "GeoNames (CC BY 4.0; https://www.geonames.org/).",
        "licenseUrl": "https://creativecommons.org/licenses/by/4.0/"
      }
    },
    "current": {
      "dataKind": "observation",
      "effectiveAt": "2026-08-20T09:52:00+00:00",
      "condition": "Mostly Cloudy",
      "conditionCode": null,
      "temperatureC": 24.4,
      "dewpointC": 21.1,
      "relativeHumidityPercent": 81,
      "windSpeedMps": 2.58,
      "windGustMps": null,
      "windFromDirectionDegrees": 250,
      "visibilityM": 16090,
      "airPressureHpa": null,
      "cloudAreaFractionPercent": null,
      "precipitationAmountMm": null,
      "precipitationPeriodHours": null
    },
    "source": {
      "provider": "NOAA/National Weather Service",
      "dataset": "NWS nearest-station latest observation",
      "dataKind": "observation",
      "stationId": "KDCA",
      "stationName": "Washington/Reagan National Airport, DC",
      "sourceUrl": "https://api.weather.gov/stations/KDCA/observations/latest",
      "pointsUrl": "https://api.weather.gov/points/38.8951,-77.0364",
      "documentationUrl": "https://www.weather.gov/documentation/services-web-api",
      "termsUrl": "https://www.weather.gov/disclaimer",
      "licenseUrl": null,
      "modelRunUpdatedAt": null,
      "fallbackReason": null,
      "upstreamAccess": "free open data",
      "attribution": "Weather observation: NOAA/National Weather Service. Place coordinates resolved from GeoNames under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/); source: https://www.geonames.org/.",
      "transformation": "API Acre selected the nearest station returned by NWS, validated the observation timestamp, and normalized supported measurements to SI units; no model values were substituted."
    },
    "retrievedAt": "2026-08-20T10:00:00+00:00",
    "cacheTtlSeconds": 900,
    "limitations": [
      "Place-name resolution uses the bundled GeoNames cities500 index, ranked by exact-name quality and population; inspect resolvedPlace and qualify ambiguous names. NWS station observations are available only within supported U.S. coverage.",
      "The nearest reporting station may be some distance from the requested point, and observations can be delayed or incomplete.",
      "Null fields mean the station omitted a supported measurement; API Acre does not estimate missing observation values.",
      "This snapshot excludes forecasts and alerts and must not be used alone for life-safety, aviation, marine, or emergency decisions."
    ]
  },
  "meta": {
    "duration_ms": 42,
    "cached": false,
    "sources": [],
    "warnings": [],
    "next_actions": [
      {
        "service": "data.us-weather-forecast",
        "title": "Global weather forecast",
        "reason": "Extend the point-in-time snapshot with a separately authorized global hourly forecast.",
        "method": "POST",
        "path": "/v1/data/us-weather-forecast",
        "price": "$0.003",
        "input_template": {
          "latitude": "$result.data.location.latitude",
          "longitude": "$result.data.location.longitude",
          "forecast_type": "hourly",
          "units": "si",
          "periods": 6,
          "include_current_conditions": false,
          "include_active_alerts": false
        },
        "use_output": "Treat this as a separate paid request. Use the snapshot's source and effectiveAt for current conditions and the forecast periods for outlooks.",
        "handoff_path": "/catalog/data.us-weather-forecast",
        "checkout_path": "/try/data.us-weather-forecast",
        "sample_path": "/samples/data.us-weather-forecast",
        "maximum_atomic_usdc": "3000",
        "handoff_payment_required": false,
        "executes_automatically": false,
        "authorization_required": true
      }
    ]
  }
}