> ## 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 Summer Trails



## OpenAPI

````yaml GET /api/v1/report/summer-trails
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/summer-trails:
    get:
      tags:
        - MtnManager
      summary: Get summer trails
      operationId: getSummerTrails
      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 summer trails at the resort with their current status,
             type (e.g. hiking, mountain biking), and optional difficulty rating.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SummerTrailsResponse'
              example:
                - uuid: 550e8400-e29b-41d4-a716-446655440000
                  name: Ridgeline Trail
                  slug: ridgeline-trail
                  number: 1
                  trail_type:
                    - hiking
                  difficulty: intermediate
                  status: open
                  condition_notes: Trail is dry and in excellent condition.
                  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.getSummerTrails();\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.GetSummerTrails(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->getSummerTrails();
                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.getSummerTrails(apiConfiguration: config)
                print(data)
            } catch {
                print("Error: \(error)")
            }
components:
  schemas:
    SummerTrailsResponse:
      description: |-
        List of all summer trails at the resort with their current status,
         type (e.g. hiking, mountain biking), and optional difficulty rating.
      type: array
      items:
        $ref: '#/components/schemas/SummerTrail'
      examples:
        - - uuid: 550e8400-e29b-41d4-a716-446655440000
            name: Ridgeline Trail
            slug: ridgeline-trail
            number: 1
            trail_type:
              - hiking
            difficulty: intermediate
            status: open
            condition_notes: Trail is dry and in excellent condition.
            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: []
    SummerTrail:
      description: |-
        Represents a single summer trail at the resort with its current status,
         type (e.g. hiking, mountain biking), and optional difficulty rating.
      type: object
      properties:
        uuid:
          description: Unique identifier for the trail.
          type: string
          examples:
            - 550e8400-e29b-41d4-a716-446655440000
        name:
          description: Display name of the trail.
          type: string
          examples:
            - Ridgeline Trail
        slug:
          description: URL-friendly name of the trail.
          type: string
          examples:
            - ridgeline-trail
        number:
          description: Optional trail number.
          type:
            - integer
            - 'null'
          format: int32
          examples:
            - 1
        trail_type:
          description: >-
            Type of trail activity (e.g. hiking, mountain_biking). Can have
            multiple.
          type: array
          items:
            $ref: '#/components/schemas/SummerTrailType'
        difficulty:
          description: Difficulty rating of the trail (optional for summer trails).
          anyOf:
            - $ref: '#/components/schemas/SummerTrailDifficulty'
            - type: 'null'
        status:
          description: Current operational status (open, closed, or unknown).
          allOf:
            - $ref: '#/components/schemas/SummerTrailStatus'
        condition_notes:
          description: Notes about current conditions on this trail.
          type: string
          examples:
            - Trail is dry and in excellent condition.
        area_uuid:
          description: UUID of the area this trail belongs to, if assigned.
          type:
            - string
            - 'null'
          examples:
            - a1b2c3d4-e5f6-7890-abcd-ef1234567890
        area_name:
          description: Name of the area this trail belongs to, if assigned.
          type:
            - string
            - 'null'
          examples:
            - Lower Mountain
        area_display_order:
          description: >-
            Display order of the area this trail belongs to, if assigned, for
            sorting purposes.
          type:
            - integer
            - 'null'
          format: int32
        updated_at:
          description: When this trail's information was last updated.
          type: string
          format: date-time
        images:
          description: |-
            Images attached to this trail, 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
        - trail_type
        - status
        - condition_notes
        - updated_at
      examples:
        - uuid: 550e8400-e29b-41d4-a716-446655440000
          name: Ridgeline Trail
          slug: ridgeline-trail
          number: 1
          trail_type:
            - hiking
          difficulty: intermediate
          status: open
          condition_notes: Trail is dry and in excellent condition.
          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: []
    SummerTrailType:
      type: string
      enum:
        - hiking
        - mountain_biking
    SummerTrailDifficulty:
      description: Difficulty rating for a summer trail.
      type: string
      enum:
        - beginner
        - intermediate
        - advanced
        - expert
    SummerTrailStatus:
      description: Operational status of a summer trail.
      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

````