Pennsylvania State University Rooms API

# authorship: DERIVED BY API EVANGELIST. Penn State's Office of Physical Plant publishes HTML
# documentation for LionSpaceFIS and no machine-readable specification of its own; this file is
# refine-openapis' per-tag split of openapi/_original/pennsylvania-state-university-fis.yaml, which we
# reconstructed from those HTML docs and from live observed responses (appVersion 1.14.0).
# The SERVICE is Penn State's; this DESCRIPTION of it is ours.
x-method: derived
x-source-url: openapi/_original/pennsylvania-state-university-fis.yaml
x-operator: institution
x-generated: '2026-08-30'
openapi: 3.2.0
info:
  title: LionSpaceFIS REST Buildings Rooms API
  description: Public REST API from the Penn State Office of Physical Plant (OPP) exposing the university's facilities and space data, the successor to the legacy FIS Facilities Information System. Exposes buildings, rooms, campuses, buildingEvents, and roomEvents entities with filtering, wildcard, and comparison operators, plus a health endpoint. This OpenAPI description was reconstructed from the public HTML documentation and from live, observed responses of the running service (appVersion 1.14.0); the provider does not publish a machine-readable specification of its own.
  version: 1.14.0
  contact:
    name: Penn State Office of Physical Plant
    url: https://apps.opp.psu.edu/fis-api/
servers:
- url: https://apps.opp.psu.edu/fis-api/v1
  description: Production v1 API
- url: https://apps.opp.psu.edu/fis-api
  description: Service root (health endpoint)
tags:
- name: Rooms
  description: Rooms within buildings.
paths:
  /rooms:
    get:
      tags:
      - Rooms
      summary: List rooms
      description: Returns rooms within buildings. Supports filtering by building id, floor, and other properties using the same comparison operators as buildings.
      operationId: listRooms
      parameters:
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/offset'
      - name: floor
        in: query
        description: Filter by room floor.
        required: false
        schema:
          type: string
      responses:
        '200':
          description: A list of rooms.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Room'
components:
  schemas:
    BuildingRef:
      type: object
      properties:
        id:
          type: string
          example: 0290012
    Campus:
      type: object
      properties:
        id:
          type: string
          example: UP
        maximoCampusCode:
          type: string
          example: UP
        lionPathCampusCode:
          type: string
          example: UP
        maximoCode:
          type: string
          example: UP
        lionPathCode:
          type: string
          example: AE
        name:
          type: string
          example: University Park
    RoomType:
      type: object
      properties:
        id:
          type: string
          example: '955'
        description:
          type: string
          example: Apartment Service
    Room:
      type: object
      properties:
        id:
          type: string
          example: 0290012-1-109D
        number:
          type: string
          example: 109D
        name:
          type:
          - string
          - 'null'
        floor:
          type: string
          example: '1'
        floorVerticalOrder:
          type:
          - integer
          - 'null'
        netArea:
          type: number
          format: double
          example: 12.09
        fireCodeCapacity:
          type: integer
          example: 0
        capacity:
          type: integer
          example: 0
        occupancy:
          type: integer
          example: 0
        photoUrl:
          type:
          - string
          - 'null'
        collegeNetKey:
          type:
          - string
          - 'null'
        businessAreaKey:
          type: string
          example: '6530'
        principalInvestigators:
          type:
          - string
          - 'null'
        occupants:
          type:
          - string
          - 'null'
        facilityCoordinators:
          type:
          - string
          - 'null'
        maximoLocation:
          type: string
          example: 0290012-109D
        lastUpdateDate:
          type: string
          format: date
          example: '2022-03-28'
        dateInactivated:
          type:
          - string
          - 'null'
          format: date
        campus:
          $ref: '#/components/schemas/Campus'
        latLong:
          $ref: '#/components/schemas/LatLong'
        building:
          $ref: '#/components/schemas/BuildingRef'
        type:
          $ref: '#/components/schemas/RoomType'
    LatLong:
      type: object
      properties:
        latitude:
          type: number
          format: double
          example: 40.79974
        longitude:
          type: number
          format: double
          example: -77.86252
  parameters:
    limit:
      name: limit
      in: query
      description: Maximum number of records to return.
      required: false
      schema:
        type: integer
        minimum: 1
    offset:
      name: offset
      in: query
      description: Number of records to skip for pagination.
      required: false
      schema:
        type: integer
        minimum: 0