Ski Resort API — Endpoints Reference

Authentication

Pass your API key in the x-api-key request header on every call. Keys are provisioned instantly at signup.

Request header

x-api-key: YOUR_API_KEY

Don't have a key? Sign up free — no credit card required.

Service health check.

GET/healthService health check.

cURL

curl https://apibarn.com/v1/ski-resort/health \
  -H "x-api-key: YOUR_API_KEY"

Query individual resorts or paginate the full catalog. Resort IDs are stable slugs (e.g. vail, whistler).

GET/api/resortsPaginated list of all resorts with current conditions summary.

Param	Type	Default	Description
`limit`	number	20	Results per page (max 200)
`offset`	number	0	Pagination offset
`country`	string	—	ISO country code, e.g. `US`
`continent`	string	—	Filter by continent name
`q`	string	—	Search by resort name

cURL

curl "https://apibarn.com/v1/ski-resort/api/resorts?limit=10&country=US" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/resorts/:idFull details for a single resort — snow, weather, lifts, trails, and forecasts.

Param	Type	Description
`id`	path	Resort slug, e.g. `vail` or `whistler`

cURL

curl https://apibarn.com/v1/ski-resort/api/resorts/vail \
  -H "x-api-key: YOUR_API_KEY"

GET/api/resorts/:id/weatherCurrent weather and 7-day forecast for a specific resort.

GET/api/resorts/:id/trailsTrail list with difficulty ratings, grooming status, and open/closed state.

GET/api/resorts/:id/liftsLift and gondola operating status, type, and capacity.

GET/api/resorts/:id/compareSide-by-side comparison of two resorts.

Param	Type	Required	Description
`with`	query	Yes	ID of the resort to compare against

cURL

curl "https://apibarn.com/v1/ski-resort/api/resorts/vail/compare?with=whistler" \
  -H "x-api-key: YOUR_API_KEY"

Ranked and filtered resort lists based on live snow and operational data.

GET/api/conditions/top-snowResorts ranked by highest recent snowfall (24h and 72h).

Param	Type	Default	Description
`limit`	number	10	Number of resorts to return (max 50)

cURL

curl "https://apibarn.com/v1/ski-resort/api/conditions/top-snow?limit=5" \
  -H "x-api-key: YOUR_API_KEY"

GET/api/conditions/open-nowResorts currently operating above a minimum open-trails threshold.

Param	Type	Default	Description
`minOpenTrailsPct`	number	50	Minimum % of trails that must be open (0–100)

GET/api/conditions/storm-watchResorts with significant snowfall forecasted in the next 48 hours.

Param	Type	Default	Description
`limit`	number	10	Number of resorts to return

Aggregated trend data across the resort network.

GET/api/insights/snowRolling snowfall totals and network-wide averages.

Param	Type	Default	Description
`days`	number	7	Rolling window in days (1–30)

Inspect the data pipeline. Conditions are pulled from Open-Meteo every 15 minutes automatically.

GET/api/sync/statusCurrent sync state — last run time, duration, and next scheduled run.

POST/api/sync/runTrigger an immediate sync. Throttled to one manual trigger per minute.

GET/api/sync/historyRecent sync run log with status, duration, and resorts updated per run.

Param	Type	Default	Description
`limit`	number	20	Number of recent runs to return (max 100)

Run real requests against the API directly from your browser. Paste your API key to get started.

Your API Key Get a key at apibarn.com/signup — free tier includes 1,000 calls/month.

Primary Resort Compare With Top Snow Limit Open-Now Min Trails %

Resorts: — | Last: None

Response

Enter your API key above to load the resort list and run live requests.