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



## OpenAPI

````yaml GET /api/v1/report/amenities
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/amenities:
    get:
      tags:
        - MtnManager
      summary: Get amenities
      operationId: getAmenities
      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 configured amenities at the resort
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AmenitiesResponse'
              example:
                - uuid: 550e8400-e29b-41d4-a716-446655440000
                  name: Summit Lodge
                  description: Mid-mountain lodge with full-service restaurant and bar.
                  category: lodge
                  website: https://example.com/summit-lodge
                  has_operating_hours: true
                  opens_at: '09:00'
                  closes_at: '16:00'
                  schedules: []
                  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.getAmenities();\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.GetAmenities(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->getAmenities();
                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.getAmenities(apiConfiguration: config)
                print(data)
            } catch {
                print("Error: \(error)")
            }
components:
  schemas:
    AmenitiesResponse:
      description: List of all configured amenities at the resort
      type: array
      items:
        $ref: '#/components/schemas/Amenity'
      examples:
        - - description: Mid-mountain lodge with full-service restaurant and bar.
            uuid: 550e8400-e29b-41d4-a716-446655440000
            name: Summit Lodge
            category: lodge
            website: https://example.com/summit-lodge
            has_operating_hours: true
            opens_at: '09:00'
            closes_at: '16:00'
            schedules: []
            images: []
    Amenity:
      description: |-
        Represents an amenity at the resort (e.g. lodge, restaurant, ski school)
         with its category, description, website, and hours.
      type: object
      properties:
        description:
          description: Description of the amenity.
          type: string
        uuid:
          description: Unique identifier for the amenity.
          type: string
          examples:
            - 550e8400-e29b-41d4-a716-446655440000
        name:
          description: Display name of the amenity.
          type: string
        category:
          description: Category classification (e.g. restaurant, lodge, ski_school).
          allOf:
            - $ref: '#/components/schemas/AmenityCategory'
        website:
          description: Website URL for the amenity, if available.
          type: string
        has_operating_hours:
          description: >-
            Whether this amenity reports operating hours. When false, clients
            should
             not expect `opens_at`, `closes_at`, or `schedules` to ever be populated.
          type: boolean
        opens_at:
          description: >-
            Today's scheduled opening time in 24-hour format (HH:MM), in
            resort's local timezone.
          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.
          type:
            - string
            - 'null'
          examples:
            - '16:00'
        schedules:
          description: >-
            Recurring operating schedules for this amenity (e.g. "Saturday &
            Sunday,
             9:00 a.m. to 4:00 p.m."), with both human-readable and structured fields.
          type: array
          items:
            $ref: '#/components/schemas/Schedule'
        images:
          description: >-
            Images attached to this amenity, 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
        - description
        - category
        - website
        - has_operating_hours
        - schedules
      examples:
        - description: Mid-mountain lodge with full-service restaurant and bar.
          uuid: 550e8400-e29b-41d4-a716-446655440000
          name: Summit Lodge
          category: lodge
          website: https://example.com/summit-lodge
          has_operating_hours: true
          opens_at: '09:00'
          closes_at: '16:00'
          schedules: []
          images: []
    AmenityCategory:
      description: Category classification for amenities
      type: string
      enum:
        - restaurant
        - coffee
        - bar
        - tubing
        - ski_school
        - rental_shop
        - daycare
        - ticketing
        - lodge
        - hotel
        - lockers
        - retail
        - other
    Schedule:
      description: >-
        Recurring schedule pattern with human-readable and machine-readable
        formats.

         Describes a regular operating schedule (e.g., "Weekends 10am-4pm") with
         both formatted strings for display and structured data for programmatic use.
      type: object
      properties:
        days_string:
          description: |-
            Human-readable description of which days this schedule applies to.
             Examples: "Daily", "Saturday & Sunday", "Monday, Wednesday, and Friday"
          type: string
          examples:
            - Saturday & Sunday
        days_of_week:
          description: |-
            Array of days of the week this schedule applies to.
             For programmatic use.
          type: array
          items:
            $ref: '#/components/schemas/DayOfWeek'
        time_string:
          description: |-
            Human-readable time range.
             Example: "9:00 AM to 4:00 PM"
          type: string
          examples:
            - 9:00 AM to 4:00 PM
        opens_at:
          description: Opening time in 24-hour format (HH:MM), in resort's local timezone.
          type: string
          examples:
            - '09:00'
          pattern: ^([01]\d|2[0-3]):[0-5]\d$
        closes_at:
          description: Closing time in 24-hour format (HH:MM), in resort's local timezone.
          type: string
          examples:
            - '16:00'
          pattern: ^([01]\d|2[0-3]):[0-5]\d$
        in_effect:
          description: |-
            Whether this schedule is currently in effect.
             `false` for upcoming schedules that haven't started yet.
          type: boolean
        effective_string:
          description: |-
            Human-readable date range when this schedule is effective.
             Example: "November 1, 2024 to April 15, 2025"
          type: string
          examples:
            - November 1, 2024 to April 15, 2025
        effective_from:
          description: Start date of the effective period (YYYY-MM-DD).
          type: string
          format: date
          examples:
            - '2024-11-01'
        effective_to:
          description: End date of the effective period (YYYY-MM-DD).
          type: string
          format: date
          examples:
            - '2025-04-15'
      required:
        - days_string
        - days_of_week
        - time_string
        - opens_at
        - closes_at
        - in_effect
        - effective_string
        - effective_from
        - effective_to
    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
    DayOfWeek:
      type: string
      enum:
        - Sunday
        - Monday
        - Tuesday
        - Wednesday
        - Thursday
        - Friday
        - Saturday

````