> ## 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 Trail Maps



## OpenAPI

````yaml GET /api/v1/report/trail-maps
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/trail-maps:
    get:
      tags:
        - MtnManager
      summary: Get trail maps
      operationId: getTrailMaps
      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 trail maps.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TrailMapsResponse'
              example:
                - uuid: 550e8400-e29b-41d4-a716-446655440000
                  name: Winter Trail Map
                  season: winter
                  display_order: 0
                  version: 1
                  hosted_url: >-
                    https://powder-mountain.mtnmanager.com/hosted/trail-map/550e8400-e29b-41d4-a716-446655440000
                  geo_bounds:
                    min_lat: 39.6403
                    max_lat: 39.65
                    min_lng: -106.3742
                    max_lng: -106.36
                    center:
                      lat: 39.64515
                      lng: -106.3671
                  entity_uuids:
                    - b2c3d4e5-f6a7-8901-bcde-f12345678901
                    - c3d4e5f6-a7b8-9012-cdef-123456789012
        '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.getTrailMaps();\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.GetTrailMaps(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->getTrailMaps();
                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.getTrailMaps(apiConfiguration: config)
                print(data)
            } catch {
                print("Error: \(error)")
            }
components:
  schemas:
    TrailMapsResponse:
      description: List of trail maps.
      type: array
      items:
        $ref: '#/components/schemas/TrailMapSummary'
      examples:
        - - uuid: 550e8400-e29b-41d4-a716-446655440000
            name: Winter Trail Map
            season: winter
            display_order: 0
            version: 1
            hosted_url: >-
              https://powder-mountain.mtnmanager.com/hosted/trail-map/550e8400-e29b-41d4-a716-446655440000
            geo_bounds:
              min_lat: 39.6403
              max_lat: 39.65
              min_lng: -106.3742
              max_lng: -106.36
              center:
                lat: 39.64515
                lng: -106.3671
            entity_uuids:
              - b2c3d4e5-f6a7-8901-bcde-f12345678901
              - c3d4e5f6-a7b8-9012-cdef-123456789012
    TrailMapSummary:
      description: Summary metadata for a trail map.
      type: object
      properties:
        uuid:
          type: string
        name:
          type: string
        season:
          $ref: '#/components/schemas/SeasonType'
        display_order:
          type: integer
          format: int64
        version:
          description: |-
            Monotonically incremented on every update. Clients can compare this
             against a cached value to decide whether to reload the trail map.
          type: integer
          format: int64
        hosted_url:
          type: string
        geo_bounds:
          description: |-
            Lat/lng bounding box of this map's georeferenced area, plus the
             centroid of its control points (used for tie-breaking when multiple
             maps cover the same point). Omitted when the map has no georeferencing.
          anyOf:
            - $ref: '#/components/schemas/GeoBounds'
            - type: 'null'
        entity_uuids:
          description: |-
            Deduplicated UUIDs of every entity (lift, run, terrain park,
             summer trail, amenity, parking lot) referenced by this map's elements.
          type: array
          items:
            type: string
      required:
        - uuid
        - name
        - season
        - display_order
        - version
        - hosted_url
        - entity_uuids
      examples:
        - uuid: 550e8400-e29b-41d4-a716-446655440000
          name: Winter Trail Map
          season: winter
          display_order: 0
          version: 1
          hosted_url: >-
            https://powder-mountain.mtnmanager.com/hosted/trail-map/550e8400-e29b-41d4-a716-446655440000
          geo_bounds:
            min_lat: 39.6403
            max_lat: 39.65
            min_lng: -106.3742
            max_lng: -106.36
            center:
              lat: 39.64515
              lng: -106.3671
          entity_uuids:
            - b2c3d4e5-f6a7-8901-bcde-f12345678901
            - c3d4e5f6-a7b8-9012-cdef-123456789012
    SeasonType:
      description: Current operating season of the resort.
      type: string
      enum:
        - winter
        - summer
        - closed
    GeoBounds:
      description: Lat/lng bounding box and centroid for a trail map's georeferenced area.
      type: object
      properties:
        min_lat:
          type: number
          format: double
        max_lat:
          type: number
          format: double
        min_lng:
          type: number
          format: double
        max_lng:
          type: number
          format: double
        center:
          $ref: '#/components/schemas/GeoPoint'
      required:
        - min_lat
        - max_lat
        - min_lng
        - max_lng
        - center
    GeoPoint:
      description: A latitude/longitude point.
      type: object
      properties:
        lat:
          type: number
          format: double
        lng:
          type: number
          format: double
      required:
        - lat
        - lng

````