> ## Documentation Index > Fetch the complete documentation index at: https://docs.mtnmanager.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Runs ## OpenAPI ````yaml GET /api/v1/report/runs openapi: 3.1.0 info: title: MtnManager API description: >- The MtnManager API provides real-time access to your ski resort’s public operational data. Use it to display current conditions on your website, mobile app, or digital signage. termsOfService: https://mtnmanager.com/terms contact: name: MtnManager Support url: https://docs.mtnmanager.com/developer/ email: support@mtnmanager.com license: name: MIT identifier: MIT version: 1.0.0 servers: - url: https://{subdomain}.mtnmanager.com variables: subdomain: default: your-resort description: Your resort's unique subdomain security: [] paths: /api/v1/report/runs: get: tags: - MtnManager summary: Get runs operationId: getRuns parameters: - in: header name: Accept-Language description: >- 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. schema: type: string example: fr-CA style: simple responses: '200': description: |- List of all runs at the resort with their current status, grooming information, and difficulty rating. content: application/json: schema: $ref: '#/components/schemas/RunsResponse' 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' images: [] '403': description: Endpoint not available for this resort. Feature may be disabled. '404': description: Resort not found. '429': description: Too many requests, temporarily rate limited. '500': description: An unexpected server error occurred. '503': description: Service temporarily unavailable. x-codeSamples: - lang: typescript label: TypeScript source: "import { MtnManagerApi, Configuration } from \"@mtnmanager/sdk\";\n\nconst api = new MtnManagerApi(\n\tnew Configuration({\n\t\tbasePath: \"https://your-resort.mtnmanager.com\",\n\t})\n);\n\ntry {\n const data = await api.getRuns();\n console.log(data);\n} catch (error) {\n console.error(error);\n}" - lang: go label: Go source: "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\tmtnmanager \"github.com/mtnmanager/mtnmanager-sdk-go\"\n)\n\nfunc main() {\n\tconfiguration := mtnmanager.NewConfiguration()\n\tconfiguration.Servers = mtnmanager.ServerConfigurations{\n\t\t{URL: \"https://your-resort.mtnmanager.com\"},\n\t}\n\tclient := mtnmanager.NewAPIClient(configuration)\n\n\tdata, _, err := client.MtnManagerAPI.GetRuns(context.Background()).Execute()\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Printf(\"%+v\\n\", data)\n}" - lang: php label: PHP source: |- setHost('https://your-resort.mtnmanager.com'); $apiInstance = new MtnManager\Api\MtnManagerApi( new GuzzleHttp\Client(), $config ); try { $result = $apiInstance->getRuns(); print_r($result); } catch (Exception $e) { echo 'Exception: ', $e->getMessage(), PHP_EOL; } - lang: swift label: Swift source: |- import MtnManagerSDK let config = MtnManagerSDKAPIConfiguration( basePath: "https://your-resort.mtnmanager.com" ) do { let data = try await MtnManagerAPI.getRuns(apiConfiguration: config) print(data) } catch { print("Error: \(error)") } components: schemas: RunsResponse: description: |- List of all runs at the resort with their current status, grooming information, and difficulty rating. type: array items: $ref: '#/components/schemas/Run' examples: - - 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' images: [] Run: description: |- Represents a single run at the resort with its current status, grooming information, and difficulty rating. type: object properties: uuid: description: Unique identifier for the run. type: string examples: - 550e8400-e29b-41d4-a716-446655440000 name: description: Display name of the run. type: string examples: - Main Street slug: description: URL-friendly name of the run. type: string examples: - main-street number: description: Optional run number. type: - integer - 'null' format: int32 examples: - 1 difficulty: description: Difficulty rating of the run. allOf: - $ref: '#/components/schemas/RunDifficulty' status: description: Current operational status (open, closed, or unknown). allOf: - $ref: '#/components/schemas/RunStatus' last_groomed: description: |- When the run was last groomed. `null` if never groomed, or if the runs grooming feature is disabled. type: - string - 'null' format: date-time groomed_today: description: Whether the run was groomed within the last 24 hours. type: boolean snowmaking: description: Whether the run has snowmaking capabilities. type: boolean night_skiing: description: Whether the run is available for night skiing. type: boolean condition_notes: description: Notes about current conditions on this run. type: string examples: - Groomer's choice! area_uuid: description: UUID of the area this run belongs to, if assigned. type: - string - 'null' examples: - a1b2c3d4-e5f6-7890-abcd-ef1234567890 area_name: description: Name of the area this run belongs to, if assigned. type: - string - 'null' examples: - Lower Mountain area_display_order: description: >- Display order of the area this run belongs to, if assigned, for sorting purposes. type: - integer - 'null' format: int32 updated_at: description: When this run's information was last updated. type: string format: date-time images: description: |- Images attached to this run, ordered for display. Each includes a ThumbHash for rendering a blurred placeholder while the image loads. type: array items: $ref: '#/components/schemas/EntityImage' default: [] required: - uuid - name - slug - difficulty - status - groomed_today - snowmaking - night_skiing - condition_notes - updated_at examples: - 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' images: [] RunDifficulty: description: Difficulty rating for a ski run. type: string enum: - beginner - intermediate - advanced - expert - terrain_park RunStatus: description: Operational status of a ski run. type: string enum: - open - closed - unknown EntityImage: description: >- A single image attached to a resort entity, with a client-supplied ThumbHash for rendering a blurred placeholder while the full image loads. type: object properties: url: description: Full public URL to the image. type: string thumb_hash: description: Base64-encoded ThumbHash for placeholder rendering. type: string required: - url - thumb_hash ````