Skip to main content
GET
/
api
/
v1
/
report
/
runs
TypeScript
import { MtnManagerApi, Configuration } from "@mtnmanager/sdk";

const api = new MtnManagerApi(
	new Configuration({
		basePath: "https://your-resort.mtnmanager.com",
	})
);

try {
    const data = await api.getRuns();
    console.log(data);
} catch (error) {
    console.error(error);
}
[
  {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Main Street",
    "slug": "main-street",
    "number": 1,
    "difficulty": "advanced",
    "status": "open",
    "last_groomed": "2026-01-26T16:26:33+00:00",
    "groomed_today": true,
    "snowmaking": true,
    "night_skiing": false,
    "condition_notes": "Groomer's choice!",
    "area_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "area_name": "Lower Mountain",
    "area_display_order": 1,
    "updated_at": "2026-01-26T16:26:33+00:00"
  }
]

Headers

​
Accept-Language
string

Preferred language and optional region for human-readable strings in the response (e.g. operating hours summaries). Supports en, fr, de, it, and es, with optional region tags such as fr-CA or de-CH. Defaults to English when omitted or unsupported.

Response

List of all runs at the resort with their current status, grooming information, and difficulty rating.

​
uuid
string
required

Unique identifier for the run.

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
name
string
required

Display name of the run.

Example:

"Main Street"

​
slug
string
required

URL-friendly name of the run.

Example:

"main-street"

​
difficulty
enum<string>
required

Difficulty rating of the run.

Available options:
beginner,
intermediate,
advanced,
expert,
terrain_park
​
status
enum<string>
required

Current operational status (open, closed, or unknown).

Available options:
open,
closed,
unknown
​
groomed_today
boolean
required

Whether the run was groomed within the last 24 hours.

​
snowmaking
boolean
required

Whether the run has snowmaking capabilities.

​
night_skiing
boolean
required

Whether the run is available for night skiing.

​
condition_notes
string
required

Notes about current conditions on this run.

Example:

"Groomer's choice!"

​
updated_at
string<date-time>
required

When this run's information was last updated.

​
number
integer<int32> | null

Optional run number.

Example:

1

​
last_groomed
string<date-time> | null

When the run was last groomed. null if never groomed, or if the runs grooming feature is disabled.

​
area_uuid
string | null

UUID of the area this run belongs to, if assigned.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

​
area_name
string | null

Name of the area this run belongs to, if assigned.

Example:

"Lower Mountain"

​
area_display_order
integer<int32> | null

Display order of the area this run belongs to, if assigned, for sorting purposes.

Example:
[
  {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Main Street",
    "slug": "main-street",
    "number": 1,
    "difficulty": "advanced",
    "status": "open",
    "last_groomed": "2026-01-26T16:26:33+00:00",
    "groomed_today": true,
    "snowmaking": true,
    "night_skiing": false,
    "condition_notes": "Groomer's choice!",
    "area_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "area_name": "Lower Mountain",
    "area_display_order": 1,
    "updated_at": "2026-01-26T16:26:33+00:00"
  }
]