> ## 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 Lifts



## OpenAPI

````yaml GET /api/v1/report/lifts
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/lifts:
    get:
      tags:
        - MtnManager
      summary: Get lifts
      operationId: getLifts
      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 lifts at the resort with their current operational
            status,
             type, and optional wait time information.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LiftsResponse'
              example:
                - uuid: 550e8400-e29b-41d4-a716-446655440000
                  name: Summit Express
                  slug: summit-express
                  number: 1
                  lift_type: gondola
                  high_speed: true
                  bubble: true
                  heated: true
                  travel_time: 12
                  length_ft: 8500
                  length_m: 2591
                  vertical_rise_ft: 2800
                  vertical_rise_m: 853
                  status: open
                  wait_time_minutes: 5
                  opens_at: '09:00'
                  closes_at: '16:00'
                  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.getLifts();\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.GetLifts(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->getLifts();
                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.getLifts(apiConfiguration: config)
                print(data)
            } catch {
                print("Error: \(error)")
            }
components:
  schemas:
    LiftsResponse:
      description: |-
        List of all lifts at the resort with their current operational status,
         type, and optional wait time information.
      type: array
      items:
        $ref: '#/components/schemas/Lift'
      examples:
        - - uuid: 550e8400-e29b-41d4-a716-446655440000
            name: Summit Express
            slug: summit-express
            number: 1
            lift_type: gondola
            high_speed: true
            bubble: true
            heated: true
            travel_time: 12
            length_ft: 8500
            length_m: 2591
            vertical_rise_ft: 2800
            vertical_rise_m: 853
            status: open
            wait_time_minutes: 5
            opens_at: '09:00'
            closes_at: '16:00'
            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: []
    Lift:
      description: >-
        Represents a single lift at the resort with its current operational
        status,
         type, and optional wait time information.
      type: object
      properties:
        uuid:
          description: Unique identifier for the lift.
          type: string
          examples:
            - 550e8400-e29b-41d4-a716-446655440000
        name:
          description: Display name of the lift.
          type: string
          examples:
            - Summit Express
        slug:
          description: URL-friendly name of the lift.
          type: string
          examples:
            - summit-express
        number:
          description: Optional lift number.
          type:
            - integer
            - 'null'
          format: int32
          examples:
            - 1
        lift_type:
          description: Type of lift (e.g. gondola, quad).
          allOf:
            - $ref: '#/components/schemas/LiftType'
        high_speed:
          description: Whether this is a high-speed/detachable lift.
          type: boolean
        bubble:
          description: Whether the lift has a bubble/cover for weather protection.
          type: boolean
        heated:
          description: Whether the lift has heated seats.
          type: boolean
        travel_time:
          description: Estimated travel time in minutes.
          type:
            - number
            - 'null'
          format: double
        length_ft:
          description: Length of the lift in feet.
          type:
            - integer
            - 'null'
          format: int32
        length_m:
          description: Length of the lift in meters.
          type:
            - integer
            - 'null'
          format: int32
        vertical_rise_ft:
          description: Vertical rise of the lift in feet.
          type:
            - integer
            - 'null'
          format: int32
        vertical_rise_m:
          description: Vertical rise of the lift in meters.
          type:
            - integer
            - 'null'
          format: int32
        status:
          description: Current operational status (open, closed, on_hold, or unknown).
          allOf:
            - $ref: '#/components/schemas/LiftStatus'
        wait_time_minutes:
          description: Current estimated wait time in minutes, if available.
          type:
            - integer
            - 'null'
          format: int64
          examples:
            - 5
        opens_at:
          description: >-
            Today's scheduled opening time in 24-hour format (HH:MM), in
            resort's local timezone.
             `null` if the lift has no scheduled hours for today.
          type:
            - string
            - 'null'
          examples:
            - '09:00'
        closes_at:
          description: >-
            Today's scheduled closing time in 24-hour format (HH:MM), in
            resort's local timezone.
             `null` if the lift has no scheduled hours for today.
          type:
            - string
            - 'null'
          examples:
            - '16:00'
        area_uuid:
          description: UUID of the area this lift belongs to, if assigned.
          type:
            - string
            - 'null'
          examples:
            - a1b2c3d4-e5f6-7890-abcd-ef1234567890
        area_name:
          description: Name of the area this lift belongs to, if assigned.
          type:
            - string
            - 'null'
          examples:
            - Lower Mountain
        area_display_order:
          description: >-
            Display order of the area this lift belongs to, if assigned, for
            sorting purposes.
          type:
            - integer
            - 'null'
          format: int32
        updated_at:
          description: When this lift's information was last updated.
          type: string
          format: date-time
        images:
          description: |-
            Images attached to this lift, 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
        - lift_type
        - high_speed
        - bubble
        - heated
        - status
        - updated_at
      examples:
        - uuid: 550e8400-e29b-41d4-a716-446655440000
          name: Summit Express
          slug: summit-express
          number: 1
          lift_type: gondola
          high_speed: true
          bubble: true
          heated: true
          travel_time: 12
          length_ft: 8500
          length_m: 2591
          vertical_rise_ft: 2800
          vertical_rise_m: 853
          status: open
          wait_time_minutes: 5
          opens_at: '09:00'
          closes_at: '16:00'
          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: []
    LiftType:
      description: Type of ski lift
      type: string
      enum:
        - gondola
        - tram
        - eight_pack
        - six_pack
        - quad
        - triple
        - double
        - magic_carpet
        - t_bar
        - platter
        - rope_tow
        - funicular
        - other
    LiftStatus:
      description: Operational status of a ski lift.
      type: string
      enum:
        - open
        - closed
        - on_hold
        - 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

````