---
title: "Featured forecast map images"
method: GET
path: "/api/v1/featured-maps"
tags: ["Maps"]
---

# Featured forecast map images

`GET /api/v1/featured-maps`

## Request

- Base URL: `https://www.snowsure.ai`
- URL: `https://www.snowsure.ai/api/v1/featured-maps`
- Auth: none declared

JSON catalog of regional snowfall forecast PNGs matching the SnowSure homepage “Featured Forecast Maps” set: region ids, period ids (24h, 72h, 7d, 14d), and fully resolved imageUrl values on the maps CDN (NEXT_PUBLIC_MAPS_CDN_URL or maps.snowsure.ai). Use for partners embedding the same static maps. Optional filters: ?period=7d &region=alps.

## Query parameters

- `period` '24h' | '72h' | '7d' | '14d'
- `region` 'alps' | 'colorado' | 'pacific-nw' | 'rockies-north' | 'hokkaido' | 'utah'

## Response `200`

Featured maps metadata and image URLs

- FeaturedMapsResponse
  - `title` string
  - `description` string
  - `scheduleNote` string
  - `cdnBase` string, uri
  - `urlPattern` string
  - `cacheEpoch` integer: Cache-bust window index (~6h)
  - `interactiveMapUrl` string, uri
  - `periods` object[]
    - `id` string
    - `label` string
  - `regions` object[]
    - `id` string
    - `label` string
  - `entries` object[]
    - `regionId` string
    - `regionLabel` string
    - `period` string
    - `periodLabel` string
    - `imageUrl` string, uri

## Other responses

- `400`: Invalid period or unknown region

---

[API](https://skmtc.dev/snowsure/apis/snowsure-api.md) · [All operations](https://skmtc.dev/snowsure/apis/snowsure-api/llms.txt) · [OpenAPI document](https://skmtc.dev/snowsure/apis/snowsure-api/revisions/dcbcdbb3df50?raw)