> ## 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 Snow Conditions



## OpenAPI

````yaml GET /api/v1/report/snow
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/snow:
    get:
      tags:
        - MtnManager
      summary: Get snow conditions
      operationId: getSnow
      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: >-
            Provides current snow conditions including base depth, surface
            conditions,
             and snowfall totals in both metric and imperial units.

             May contain multiple, representing different reporting areas.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SnowResponse'
              example:
                - uuid: 550e8400-e29b-41d4-a716-446655440000
                  area_uuid: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                  area_name: Lower Mountain
                  area_display_order: 1
                  base_depth_cm: 152
                  base_depth_in: 60
                  surface_condition: BS
                  secondary_surface_condition: PP
                  condition_notes: Machine groomed on main runs, natural powder in tree areas.
                  snowfall_cm:
                    overnight: 8
                    last_24h: 12
                    last_48h: 18
                    last_7days: 36
                    season_total: 156
                  snowfall_in:
                    overnight: 8
                    last_24h: 12
                    last_48h: 18
                    last_7days: 36
                    season_total: 156
                  reported_at: '2026-01-26T16:26:33+00:00'
        '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.getSnow();\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.GetSnow(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: |-
            <?php
            require_once(__DIR__ . '/vendor/autoload.php');

            $config = MtnManager\Configuration::getDefaultConfiguration()
                ->setHost('https://your-resort.mtnmanager.com');

            $apiInstance = new MtnManager\Api\MtnManagerApi(
                new GuzzleHttp\Client(),
                $config
            );

            try {
                $result = $apiInstance->getSnow();
                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.getSnow(apiConfiguration: config)
                print(data)
            } catch {
                print("Error: \(error)")
            }
components:
  schemas:
    SnowResponse:
      description: >-
        Provides current snow conditions including base depth, surface
        conditions,
         and snowfall totals in both metric and imperial units.

         May contain multiple, representing different reporting areas.
      type: array
      items:
        $ref: '#/components/schemas/SnowReport'
      examples:
        - - uuid: 550e8400-e29b-41d4-a716-446655440000
            area_uuid: a1b2c3d4-e5f6-7890-abcd-ef1234567890
            area_name: Lower Mountain
            area_display_order: 1
            base_depth_cm: 152
            base_depth_in: 60
            surface_condition: BS
            secondary_surface_condition: PP
            condition_notes: Machine groomed on main runs, natural powder in tree areas.
            snowfall_cm:
              overnight: 8
              last_24h: 12
              last_48h: 18
              last_7days: 36
              season_total: 156
            snowfall_in:
              overnight: 8
              last_24h: 12
              last_48h: 18
              last_7days: 36
              season_total: 156
            reported_at: '2026-01-26T16:26:33+00:00'
    SnowReport:
      description: >-
        Provides current snow conditions for a specific area or the entire
        resort,
         including base depth, surface conditions, and snowfall totals in both
         metric and imperial units.
      type: object
      properties:
        uuid:
          description: Unique identifier for this snow report.
          type: string
          examples:
            - 550e8400-e29b-41d4-a716-446655440000
        area_uuid:
          description: |-
            UUID of the area this report covers, if area-specific.
             `null` for resort-wide reports.
          type:
            - string
            - 'null'
          examples:
            - a1b2c3d4-e5f6-7890-abcd-ef1234567890
        area_name:
          description: Name of the area this report covers, if area-specific.
          type:
            - string
            - 'null'
          examples:
            - Lower Mountain
        area_display_order:
          description: >-
            Display order of the area this report covers, if area-specific, for
            sorting purposes.
          type:
            - integer
            - 'null'
          format: int32
        base_depth_cm:
          description: |-
            Current base depth in centimeters.
             Not included if the base depth feature is disabled.
          type:
            - integer
            - 'null'
          format: int32
          examples:
            - 152
        base_depth_in:
          description: |-
            Current base depth in inches.
             Not included if the base depth feature is disabled.
          type:
            - integer
            - 'null'
          format: int32
          examples:
            - 60
        surface_condition:
          description: |-
            Primary surface condition using industry standard codes.
             Not included if the snow surface condition feature is disabled.

             - BS (Bare Spots)
             - CO (Corn Snow)
             - FG (Frozen Granular)
             - HP (Hard Pack)
             - IP (Ice Patches)
             - IS (Icy Surface)
             - LG (Loose Granular)
             - MG (Machine Groomed)
             - P (Powder)
             - PP (Packed Powder)
             - SC (Spring Conditions)
             - TC (Thin Cover)
             - V (Variable)
             - WG (Wet Granular)
             - WP (Wet Powder)
          anyOf:
            - $ref: '#/components/schemas/SurfaceCondition'
            - type: 'null'
        secondary_surface_condition:
          description: |-
            Secondary surface condition using industry standard codes.
             Not included if the secondary snow surface condition feature is disabled.

             - BS (Bare Spots)
             - CO (Corn Snow)
             - FG (Frozen Granular)
             - HP (Hard Pack)
             - IP (Ice Patches)
             - IS (Icy Surface)
             - LG (Loose Granular)
             - MG (Machine Groomed)
             - P (Powder)
             - PP (Packed Powder)
             - SC (Spring Conditions)
             - TC (Thin Cover)
             - V (Variable)
             - WG (Wet Granular)
             - WP (Wet Powder)
          anyOf:
            - $ref: '#/components/schemas/SurfaceCondition'
            - type: 'null'
        condition_notes:
          description: Additional notes about current snow conditions, e.g. groomer's notes
          type: string
          examples:
            - Machine groomed on main runs, natural powder in tree areas.
        snowfall_cm:
          description: Snowfall accumulation metrics in centimeters.
          allOf:
            - $ref: '#/components/schemas/SnowMetrics'
        snowfall_in:
          description: Snowfall accumulation metrics in inches.
          allOf:
            - $ref: '#/components/schemas/SnowMetrics'
        reported_at:
          description: When this snow report was last updated.
          type: string
          format: date-time
      required:
        - uuid
        - condition_notes
        - snowfall_cm
        - snowfall_in
        - reported_at
      examples:
        - uuid: 550e8400-e29b-41d4-a716-446655440000
          area_uuid: a1b2c3d4-e5f6-7890-abcd-ef1234567890
          area_name: Lower Mountain
          area_display_order: 1
          base_depth_cm: 152
          base_depth_in: 60
          surface_condition: BS
          secondary_surface_condition: PP
          condition_notes: Machine groomed on main runs, natural powder in tree areas.
          snowfall_cm:
            overnight: 8
            last_24h: 12
            last_48h: 18
            last_7days: 36
            season_total: 156
          snowfall_in:
            overnight: 8
            last_24h: 12
            last_48h: 18
            last_7days: 36
            season_total: 156
          reported_at: '2026-01-26T16:26:33+00:00'
    SurfaceCondition:
      description: Industry-standard letter codes describing snow surface conditions.
      type: string
      enum:
        - BS
        - CO
        - FG
        - HP
        - IP
        - IS
        - LG
        - MG
        - P
        - PP
        - SC
        - TC
        - V
        - WG
        - WP
    SnowMetrics:
      description: |-
        Contains snowfall totals for various time periods. Values are provided
         in the unit indicated by the parent field name (cm or inches).
      type: object
      properties:
        overnight:
          description: >-
            Snowfall during the overnight window (midnight to 9 AM local
            timezone).
          type: integer
          format: int32
          examples:
            - 8
        last_24h:
          description: Snowfall in the last 24 hours.
          type: integer
          format: int32
          examples:
            - 12
        last_48h:
          description: Snowfall in the last 48 hours.
          type: integer
          format: int32
          examples:
            - 18
        last_7days:
          description: Snowfall in the last 7 days.
          type: integer
          format: int32
          examples:
            - 36
        season_total:
          description: Total snowfall for the current season.
          type: integer
          format: int32
          examples:
            - 156
      required:
        - overnight
        - last_24h
        - last_48h
        - last_7days
        - season_total
      examples:
        - overnight: 8
          last_24h: 12
          last_48h: 18
          last_7days: 36
          season_total: 156

````