Recipes

Recipe: Current Conditions

This recipe shows how to retrieve live weather data — temperature, weather phrase, precipitation status, and more — for a specific location.

These recipes are teaching examples — not production code.

Host: examples use the development host apidev.accuweather.com. Switch to api.accuweather.com for production.
Production hardening: GZIP compression, caching, retries with exponential backoff, and error handling are not included. See the Best Practices guide.

Scenario

"I want to show users the current temperature and weather description for their city right now."

You'll need a LocationKey before starting. If you don't have one, follow the Location Search recipe first. For this example we use LocationKey 349727 (New York City).

Call the Current Conditions endpoint with your LocationKey.

Endpoint:

Code
GET https://apidev.accuweather.com/currentconditions/v1/{locationKey}.json?apikey={YOUR_API_KEY}

Extended details

Add details=true to receive an expanded set of fields including humidity, wind, UV index, ceiling, and more.

Additional fields returned with details=true:


Code
{
  "RelativeHumidity": 55,
  "DewPoint": {
    "Metric": { "Value": 14.4, "Unit": "C", "UnitType": 17 },
    "Imperial": { "Value": 58, "Unit": "F", "UnitType": 18 }
  },
  "Wind": {
    "Direction": { "Degrees": 200, "Localized": "SSW", "English": "SSW" },
    "Speed": {
      "Metric": { "Value": 14.5, "Unit": "km/h", "UnitType": 7 },
      "Imperial": { "Value": 9, "Unit": "mi/h", "UnitType": 9 }
    }
  },
  "UVIndex": 5,
  "UVIndexText": "Moderate",
  "Visibility": {
    "Metric": { "Value": 16.1, "Unit": "km", "UnitType": 6 },
    "Imperial": { "Value": 10, "Unit": "mi", "UnitType": 2 }
  },
  "Pressure": {
    "Metric": { "Value": 1013.7, "Unit": "mb", "UnitType": 14 },
    "Imperial": { "Value": 29.93, "Unit": "inHg", "UnitType": 12 }
  },
  "CloudCover": 40,
  "ApparentTemperature": {
    "Metric": { "Value": 23.9, "Unit": "C", "UnitType": 17 },
    "Imperial": { "Value": 75, "Unit": "F", "UnitType": 18 }
  }
}

Key response fields

Field	Type	Description
`WeatherText`	String	Plain-language current conditions (e.g., "Partly cloudy")
`WeatherIcon`	Integer	Icon code (1–44); maps to AccuWeather icon set
`HasPrecipitation`	Boolean	Whether precipitation is currently falling
`PrecipitationType`	String \| null	`"Rain"`, `"Snow"`, `"Ice"`, `"Mixed"`, or `null`
`IsDayTime`	Boolean	Whether it is currently daytime at the location
`Temperature.Metric.Value`	Number	Current temperature in Celsius
`Temperature.Imperial.Value`	Number	Current temperature in Fahrenheit
`LocalObservationDateTime`	String	ISO 8601 timestamp of the observation
`EpochTime`	Integer	Unix epoch timestamp of the observation

Get historical current conditions

The API also supports the past 6 hours and past 24 hours of observations:

Code
# Past 6 hours
curl "https://apidev.accuweather.com/currentconditions/v1/349727/historical.json?apikey={YOUR_API_KEY}"

# Past 24 hours
curl "https://apidev.accuweather.com/currentconditions/v1/349727/historical/24.json?apikey={YOUR_API_KEY}"

Each returns an array of up to 6 (or 24) observation snapshots in reverse chronological order.

Complete code sample

Copy a full, runnable example that fetches current conditions and prints a summary.

Next steps

Hourly Forecast — plan ahead with hour-by-hour data
5-Day Daily Forecast — multi-day high/low summaries

Last modified on May 7, 2026

Location Search Hourly Forecast

Recipes

Recipe: Current Conditions

This recipe shows how to retrieve live weather data — temperature, weather phrase, precipitation status, and more — for a specific location.

These recipes are teaching examples — not production code.

Host: examples use the development host apidev.accuweather.com. Switch to api.accuweather.com for production.
Production hardening: GZIP compression, caching, retries with exponential backoff, and error handling are not included. See the Best Practices guide.

Scenario

"I want to show users the current temperature and weather description for their city right now."

You'll need a LocationKey before starting. If you don't have one, follow the Location Search recipe first. For this example we use LocationKey 349727 (New York City).

Call the Current Conditions endpoint with your LocationKey.

Endpoint:

Code
GET https://apidev.accuweather.com/currentconditions/v1/{locationKey}.json?apikey={YOUR_API_KEY}

const apiKey = "{YOUR_API_KEY}";
const locationKey = "349727";

const response = await fetch(
  `https://apidev.accuweather.com/currentconditions/v1/${locationKey}.json?apikey=${apiKey}`
);
const data: Record<string, any>[] = await response.json();
const conditions = data[0]; // API returns an array; take the first element

Extended details

Add details=true to receive an expanded set of fields including humidity, wind, UV index, ceiling, and more.

const detailsResponse = await fetch(
  `https://apidev.accuweather.com/currentconditions/v1/${locationKey}.json?apikey=${apiKey}&details=true`
);
const detailedData: Record<string, any>[] = await detailsResponse.json();

Additional fields returned with details=true:


Code
{
  "RelativeHumidity": 55,
  "DewPoint": {
    "Metric": { "Value": 14.4, "Unit": "C", "UnitType": 17 },
    "Imperial": { "Value": 58, "Unit": "F", "UnitType": 18 }
  },
  "Wind": {
    "Direction": { "Degrees": 200, "Localized": "SSW", "English": "SSW" },
    "Speed": {
      "Metric": { "Value": 14.5, "Unit": "km/h", "UnitType": 7 },
      "Imperial": { "Value": 9, "Unit": "mi/h", "UnitType": 9 }
    }
  },
  "UVIndex": 5,
  "UVIndexText": "Moderate",
  "Visibility": {
    "Metric": { "Value": 16.1, "Unit": "km", "UnitType": 6 },
    "Imperial": { "Value": 10, "Unit": "mi", "UnitType": 2 }
  },
  "Pressure": {
    "Metric": { "Value": 1013.7, "Unit": "mb", "UnitType": 14 },
    "Imperial": { "Value": 29.93, "Unit": "inHg", "UnitType": 12 }
  },
  "CloudCover": 40,
  "ApparentTemperature": {
    "Metric": { "Value": 23.9, "Unit": "C", "UnitType": 17 },
    "Imperial": { "Value": 75, "Unit": "F", "UnitType": 18 }
  }
}

Key response fields

Field	Type	Description
`WeatherText`	String	Plain-language current conditions (e.g., "Partly cloudy")
`WeatherIcon`	Integer	Icon code (1–44); maps to AccuWeather icon set
`HasPrecipitation`	Boolean	Whether precipitation is currently falling
`PrecipitationType`	String \| null	`"Rain"`, `"Snow"`, `"Ice"`, `"Mixed"`, or `null`
`IsDayTime`	Boolean	Whether it is currently daytime at the location
`Temperature.Metric.Value`	Number	Current temperature in Celsius
`Temperature.Imperial.Value`	Number	Current temperature in Fahrenheit
`LocalObservationDateTime`	String	ISO 8601 timestamp of the observation
`EpochTime`	Integer	Unix epoch timestamp of the observation

Get historical current conditions

The API also supports the past 6 hours and past 24 hours of observations:

Code
# Past 6 hours
curl "https://apidev.accuweather.com/currentconditions/v1/349727/historical.json?apikey={YOUR_API_KEY}"

# Past 24 hours
curl "https://apidev.accuweather.com/currentconditions/v1/349727/historical/24.json?apikey={YOUR_API_KEY}"

Each returns an array of up to 6 (or 24) observation snapshots in reverse chronological order.

Complete code sample

Copy a full, runnable example that fetches current conditions and prints a summary.

const API_KEY = "{YOUR_API_KEY}";
const locationKey = "349727";

// Step 1: Fetch current conditions
const res = await fetch(
  `https://apidev.accuweather.com/currentconditions/v1/${locationKey}.json?apikey=${API_KEY}`
);
const data: Record<string, any>[] = await res.json();

// Step 2: Parse the first item from the array
const conditions = data[0];

// Step 3: Display a formatted summary
console.log("\nCurrent Conditions");
console.log("━".repeat(42));
console.log(`Conditions:    ${conditions.WeatherText}`);
console.log(`Temperature:   ${conditions.Temperature.Imperial.Value}°F / ${conditions.Temperature.Metric.Value}°C`);
console.log(`Precipitation: ${conditions.HasPrecipitation ? "Yes" : "None"}`);
console.log(`Daytime:       ${conditions.IsDayTime}`);

Next steps

Hourly Forecast — plan ahead with hour-by-hour data
5-Day Daily Forecast — multi-day high/low summaries

Last modified on May 7, 2026

Location Search Hourly Forecast

Scenario

1Make the request

2Inspect the response

3Display the data

Extended details

Key response fields

Get historical current conditions

Complete code sample

Next steps

Scenario

1Make the request

2Inspect the response

3Display the data

Extended details

Key response fields

Get historical current conditions

Complete code sample

Next steps