openapi: 3.2.0
info:
  title: AMETEK Powervar iSite PRO REST UPS Monitoring API
  version: v1
  summary: Read-only REST API embedded in the AMETEK Powervar iSite PRO network management card.
  description: The REST API published by AMETEK Powervar for the iSite PRO network management adapter, a card fitted to Powervar UPS systems for secure remote monitoring.
  contact:
    name: AMETEK Powervar
    url: https://www.powervar.com
  x-source-pdf: https://www.powervar.com/-/media/ametekpowervar/pdf/products/connectivity-solutions/isite-pro/user-manuals/a55-00202-rev-b-isite-pro-rest-api-definition.pdf
servers:
- url: http://{device_host}:{port}/api/v1
  description: The iSite PRO adapter itself. `device_host` is the adapter's own IP address or mDNS hostname (the document's worked examples use an adapter reachable on port 8080 and a hostname of the form isitepro-<serial>). HTTPS is supported; HTTP is the factory default.
  variables:
    device_host:
      default: isitepro.local
      description: IP address or mDNS hostname of the customer's iSite PRO adapter.
    port:
      default: '80'
      description: HTTP listener port reported by the adapter's own httpd.port field. Examples in the definition use 8080.
security:
- basicAuth: []
- sessionToken: []
tags:
- name: UPS Monitoring
  description: Read the live electrical, battery and load state of the attached UPS.
paths:
  /UpsStatus:
    get:
      operationId: getUpsStatus
      summary: Get UPS status
      description: Returns the current electrical and battery state of the UPS attached to the iSite PRO adapter. No URL parameters, data parameters or request headers beyond authentication.
      tags:
      - UPS Monitoring
      responses:
        '200':
          description: Current UPS status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpsStatus'
components:
  schemas:
    UpsStatus:
      type: object
      title: UpsStatus
      description: Live UPS state. Field set taken verbatim from the published example response body.
      properties:
        BatteryTemperature:
          type: number
          description: Battery temperature (degrees Celsius in the published example).
        BatteryStatus:
          type: string
          description: Battery health summary, e.g. "Normal".
        TotalTimesDepleted:
          type: integer
          description: Cumulative count of full battery depletions.
        TotalMinutesOnBattery:
          type: integer
          description: Cumulative minutes the UPS has run on battery.
        EstimatedChargeRemaining:
          type: integer
          description: Estimated remaining charge as a percentage.
        OutputSource:
          type: string
          description: Present output source, e.g. "Normal".
        OutputPower:
          type: number
          description: Present output power.
        InputLineBads:
          type: integer
          description: Cumulative count of bad input line conditions.
        InputMaxVolts:
          type: number
          description: Maximum observed input voltage.
        InputMinVolts:
          type: number
          description: Minimum observed input voltage.
        OutputFrequency:
          type: number
          description: Output frequency in Hz.
        InputFrequency:
          type: number
          description: Input frequency in Hz.
        SerialNumber:
          type: string
          description: UPS serial number.
        BatteryVoltage:
          type: number
          description: Present battery voltage.
        BatteryCurrent:
          type: number
          description: Present battery current.
        ManufactureDate:
          type: string
          description: Manufacture date. Published example uses ISO form YYYY-MM-DD.
        BatteryReplaceDate:
          type: string
          description: Battery replacement date. Published example uses MM/DD/YYYY — note this differs from ManufactureDate.
        InputVoltage:
          type: number
          description: Present input voltage.
        OutputVoltage:
          type: number
          description: Present output voltage.
        EstimatedMinutesRemaining:
          type: integer
          description: Estimated runtime remaining on battery, in minutes.
        TotalTimesOnBattery:
          type: integer
          description: Cumulative count of transfers to battery.
        UpsUpTime:
          type: integer
          description: UPS uptime.
        OutputPercentLoad:
          type: number
          description: Present output load as a percentage of capacity.
      example:
        BatteryTemperature: 27
        BatteryStatus: Normal
        TotalTimesDepleted: 1
        TotalMinutesOnBattery: 293
        EstimatedChargeRemaining: 100
        OutputSource: Normal
        OutputPower: 0
        InputLineBads: 150
        InputMaxVolts: 122
        OutputFrequency: 60
        SerialNumber: 5006003R-1830016
        BatteryVoltage: 27.3
        ManufactureDate: '2021-02-01'
        InputVoltage: 114
        OutputVoltage: 116
        BatteryCurrent: 0
        EstimatedMinutesRemaining: 6000
        BatteryReplaceDate: 03/01/2021
        InputFrequency: 60
        InputMinVolts: 95
        TotalTimesOnBattery: 150
        UpsUpTime: 0
        OutputPercentLoad: 0
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: HTTP Basic Authentication, as published. Authentication is required for access to all API features. Credentials are the adapter's own local administrative credentials.
    sessionToken:
      type: apiKey
      in: header
      name: x-auth-token
      description: Web session token issued by the adapter's own web interface and presented in the `x-auth-token` header, as published.
x-authored-by: API Evangelist
x-generated-from: documentation
x-modeled-from: https://www.powervar.com/-/media/ametekpowervar/pdf/products/connectivity-solutions/isite-pro/user-manuals/a55-00202-rev-b-isite-pro-rest-api-definition.pdf
x-provenance:
  method: generated
  generated: '2026-09-02'
  source_document: A55-00202 REV B — "Rest API Definition", AMETEK Powervar, Inc., dated 03/10/2023
  source_url: https://www.powervar.com/-/media/ametekpowervar/pdf/products/connectivity-solutions/isite-pro/user-manuals/a55-00202-rev-b-isite-pro-rest-api-definition.pdf
  http_status: 200
  note: Transcribed by API Evangelist from AMETEK Powervar's own published REST API definition PDF. AMETEK Powervar publishes no OpenAPI of its own. Every path, method, header, status code and response field below appears verbatim in that document; nothing has been inferred or invented. Response schemas are typed from the document's worked example bodies. Undocumented behaviour (error responses, rate limits) is deliberately ABSENT rather than guessed.