import {
  Droplets,
  Sun,
  CloudSun,
  MapPinned,
  CloudAlert,
  CloudRainWind,
  Siren,
  Map,
  Gauge,
  Zap,
  Wind,
  Waves,
  Moon,
  Globe,
  Link2,
  FileText,
  Activity,
  Thermometer,
  Clock,
  BookOpen,
  Rocket,
  ChefHat,
  Lightbulb,
  Palette,
  Ruler,
  LayoutTemplate,
  Library,
  MessageCircleQuestion,
  History,
  HeartPulse,
} from "zudoku/icons";
import { ApiLink } from "../../src/components/ApiLink.tsx";

# AccuWeather Enterprise API

The AccuWeather Enterprise API delivers comprehensive, global weather data through a RESTful interface. From real-time conditions to 90-day forecasts, severe weather alerts to minute-by-minute precipitation predictions — everything you need to build weather-aware applications at scale.

---

## API Resources

<div className="grid sm:grid-cols-2 gap-1 not-prose">
  <ApiLink icon={<Droplets size={20} />} title="MinuteCast®" href="/developers/forecasts/guide">
    Hyperlocal minute-by-minute precipitation forecasts pinpointed to an exact latitude and longitude.
  </ApiLink>
  <ApiLink icon={<Sun size={20} />} title="Forecasts" href="/developers/forecasts/guide">
    Daily and hourly forecasts for 70+ parameters including RealFeel® temperature and precipitation probabilities.
  </ApiLink>
  <ApiLink icon={<CloudSun size={20} />} title="Current Conditions" href="/developers/current-conditions/guide">
    Current and historical conditions for the last 24 hours on key data like temperature, precipitation, UV index, relative humidity, and wind speeds.
  </ApiLink>
  <ApiLink icon={<MapPinned size={20} />} title="Locations" href="/developers/locations/guide">
    Lookup locations by cityname, postal code, GPS coordinates, or points of interest — across 3.5 million+ locations worldwide, in 200+ languages and dialects.
  </ApiLink>
  <ApiLink icon={<CloudAlert size={20} />} title="Alerts" href="/developers/alerts/guide">
    Global severe weather alerts from official government agencies and AccuWeather proprietary alerts.
  </ApiLink>
  <ApiLink icon={<Zap size={20} />} title="Lightning" href="/developers/lightning/guide">
    Lightning forecasts by latitude and longitude. Get historical and current lightning strike data from the AccuWeather Lightning Network™.
  </ApiLink>
  <ApiLink icon={<Gauge size={20} />} title="Lifestyle Indices" href="/developers/indices/guide">
    50+ lifestyle indices including AccuLumen Brightness Index™, common cold, flu, outdoor activities, skin care, and allergen forecasts.
  </ApiLink>
  <ApiLink icon={<CloudRainWind size={20} />} title="Tropical" href="/developers/tropical/guide">
    Active and historical government-issued tropical cyclone information including current and forecast conditions like storm position and wind speed.
  </ApiLink>
  <ApiLink icon={<Map size={20} />} title="Maps" href="/developers/maps/general">
    Radar, satellite, and future radar overlay tiles, designed to layer seamlessly onto mapping platforms.
  </ApiLink>
  <ApiLink icon={<Siren size={20} />} title="Alarms" href="/developers/weather-alarms/guide">
    Threshold-based alarms for rain, snow, ice, sustained wind, and thunderstorm probability.
  </ApiLink>
  <ApiLink icon={<Globe size={20} />} title="Imagery" href="/developers/imagery/guide">
    Radar and satellite images for a specific location in various resolutions.
  </ApiLink>
  <ApiLink icon={<Wind size={20} />} title="Air Quality" href="/developers/air-quality/guide">
    Current, hourly and daily forecasted air quality conditions, with index values, dominant pollutants, and health guidance.
  </ApiLink>
  <ApiLink icon={<Thermometer size={20} />} title="Climatology" href="/developers/climo/guide">
     Location-based climatology data - including daily observations, records, normals and monthly summaries.
  </ApiLink>
  <ApiLink icon={<Clock size={20} />} title="Historical" href="/developers/historical/guide">
    Archived weather observations since 1990 for 85,000+ global locations, in multiple languages and formats.
  </ApiLink>
  <ApiLink icon={<Waves size={20} />} title="Tidal Forecasts" href="/developers/tidal-forecast/guide">
    Tide predictions with high/low tide times and levels for coastal locations, with forecast ranges from 1 to 45 days.
  </ApiLink>
  <ApiLink icon={<Moon size={20} />} title="Astronomy" href="/developers/astronomy/guide">
    Sun and moon rise/set times and moon phases — past, present, and future.
  </ApiLink>
  <ApiLink icon={<BookOpen size={20} />} title="Translations" href="/developers/translations/guide">
    Localization of weather content in over 200 languages and dialects.
  </ApiLink>
  <ApiLink icon={<Link2 size={20} />} title="Deep Links" href="/developers/deep-links/guide">
    Direct links to forecasts, conditions, and other content on AccuWeather.com.
  </ApiLink>
  <ApiLink icon={<FileText size={20} />} title="Reports" href="/developers/reports/guide">
    Detailed reports on severe weather events like hail, strong winds, and flooding, with location, timing, and impact details.
  </ApiLink>
  <ApiLink icon={<Activity size={20} />} title="River Gauge" href="/developers/river-gauge/guide">
    River water level observations, station metadata, and flood stage information.
  </ApiLink>
</div>

---

## Getting Started

### Base URLs

| Environment     | Hostname                 |
| --------------- | ------------------------ |
| **Development** | `apidev.accuweather.com` |
| **Production**  | `api.accuweather.com`    |

### Authentication

All requests require a valid API key passed as a query parameter:

```
https://apidev.accuweather.com/forecasts/v1/daily/1day/347625?apikey=YOUR_API_KEY
```

:::tip{title="Get an API key"}

- **Enterprise (full access):** Contact [sales@accuweather.com](mailto:sales@accuweather.com) for an Enterprise API key.
- **Free trial (limited access):** Sign up at the [AccuWeather Developer Portal](https://developer.accuweather.com) for a sampling of APIs.

:::

If required by the terms of your agreement, a [partner code](/developers/partner-code) will be provided by your AccuWeather representative. Append the assigned partner code to the links provided in the output.

### Response Format

All endpoints return **JSON** (`application/json`) by default with **UTF-8** encoding. Select APIs also support **GeoJSON** and **CSV** output formats.

### Transport Security

HTTPS is required on all endpoints.

### Language Support

Data is available in **200+ languages and dialects**. 
---

## Response Codes

| Code  | Status              | Description                                                                                                                                                     |
| ----- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `200` | OK                  | Request fulfilled successfully                                                                                                                                  |
| `400` | Bad Request         | Request contained invalid syntax or parameters. Pass `allowError=false` in the query to suppress error codes (response will always be 200, barring a 500 error) |
| `403` | Forbidden           | Valid API key was not supplied                                                                                                                                  |
| `404` | Not Found           | No route matching the request URI was found                                                                                                                     |
| `409` | Conflict            | Allowed request limit has been exceeded                                                                                                                         |
| `500` | Internal Error      | The server encountered an unexpected condition                                                                                                                  |
| `503` | Service Unavailable | The server is currently unavailable                                                                                                                             |

---

## Additional Resources

### Get started

<div className="grid sm:grid-cols-2 gap-1 not-prose">
  <ApiLink icon={<Rocket size={20} />} title="Quick Start Guides" href="/developers/quick-start-guides">
    Step-by-step guides in multiple languages to make your first API calls.
  </ApiLink>
  <ApiLink icon={<ChefHat size={20} />} title="Recipes" href="/recipes/overview">
    End-to-end walkthroughs for common tasks like location search, current conditions, and forecasts.
  </ApiLink>
  <ApiLink icon={<Lightbulb size={20} />} title="Best Practices" href="/developers/best-practices">
    Optimize your integration for performance and reliability.
  </ApiLink>
</div>

### Reference

<div className="grid sm:grid-cols-2 gap-1 not-prose">
  <ApiLink icon={<Palette size={20} />} title="Weather Icons" href="/developers/weather-icons">
    Icon set reference for weather conditions returned by the API.
  </ApiLink>
  <ApiLink icon={<Ruler size={20} />} title="Unit Types" href="/developers/unit-types">
    Supported measurement units — Imperial, Metric, and more.
  </ApiLink>
  <ApiLink icon={<LayoutTemplate size={20} />} title="Display Formats" href="/developers/data-display-formatting">
    Formatting standards for displaying weather data in your app.
  </ApiLink>
  <ApiLink icon={<Library size={20} />} title="Glossary" href="/developers/glossary">
    Definitions for weather and API terminology used throughout the docs.
  </ApiLink>
</div>

### Stay informed

<div className="grid sm:grid-cols-2 gap-1 not-prose">
  <ApiLink icon={<MessageCircleQuestion size={20} />} title="FAQ" href="/developers/faq">
    Frequently asked questions about the AccuWeather Enterprise API.
  </ApiLink>
  <ApiLink icon={<History size={20} />} title="Change Log" href="/developers/change-log">
    Latest API updates, additions, and changes.
  </ApiLink>
  <ApiLink icon={<HeartPulse size={20} />} title="Status Page" href="https://status.accuweather.com" external>
    24/7 service availability for AccuWeather products and services.
  </ApiLink>
</div>