> ## Documentation Index > Fetch the complete documentation index at: https://docs.plantpredict.com/llms.txt > Use this file to discover all available pages before exploring further. # List all accessible inverters > # Get All Inverters Returns a list of all available Inverters in the system. ## Overview This endpoint retrieves a comprehensive list of all inverter configurations stored in the database. Each inverter entry contains detailed technical specifications, power ratings, voltage limits, efficiency curves, and metadata about ownership and modification history. ## Response Fields ### Status & Identification - **id** - Unique identifier for the inverter record - **name** - Display name of the inverter (typically includes manufacturer, model, and specifications) - **status** - Current status of the inverter record: - `2` - Active/Published - `5` - Archived - `6` - Legacy/Deprecated - **description** - Optional notes or additional information about the inverter configuration ### Manufacturer & Model Information - **manufacturer** - Inverter manufacturer name (e.g., "ABB") - **model** - Specific model identifier (e.g., "PVS800-57-1000kW-C") - **inverterType** - Classification of inverter type: - `2` - Central inverter - Other values may represent string or micro inverters ### Power Specifications - **powerRated** - Rated AC power output in kilowatts (kW) - **apparentPower** - Apparent power capacity in kilovolt-amperes (kVA) - **minDCPowerThreshold** - Minimum DC power threshold in watts (W) for operation - **outputVoltage** - AC output voltage in volts (V) ### Voltage & Current Limits - **minVoltage** - Minimum DC input voltage in volts (V) - **maxMPPVoltage** - Maximum power point tracking voltage in volts (V) - **maxAbsoluteVoltage** - Maximum absolute DC voltage limit in volts (V) - **maxCurrent** - Maximum DC input current in amperes (A) ### Environmental & Physical Constraints - **maxElevation** - Maximum operating elevation in meters above sea level ### Curve Settings & Data Configuration - **usekVACurves** - Boolean flag indicating whether kVA derating curves are enabled - **usePQCurves** - Boolean flag indicating whether power quality curves are enabled - **dataSource** - Source identifier for the inverter data: - `2` - Standard/manufacturer data - Other values may indicate custom or imported data - **efficiencyCurves** - Array of efficiency curve data points (null if not configured) - **kVACurves** - Array of kVA derating curve data (null if not configured) - **pqCurves** - Array of power quality curve data (null if not configured) ### Ownership & Company Information - **companyId** - ID of the company that owns this inverter configuration - **company** - Company object (typically null in list responses) - **ownerId** - User ID of the inverter configuration owner - **owner** - Owner user object (typically null in list responses) ### Audit & Modification Tracking - **createdDate** - ISO 8601 timestamp when the inverter was created - **lastModified** - ISO 8601 timestamp of the most recent modification - **lastModifiedById** - User ID of the person who last modified the record - **lastModifiedBy** - Detailed user object containing: - **id** - User ID - **email** - User email address - **firstName** / **lastName** - User's name - **jobTitle** - User's job title - **companyId** - User's company affiliation - **status** - User account status (0 = system account, 1 = active) - **createdDateUtc** - When the user account was created - **lastLoginDateUTC** - Most recent login timestamp - **uuid** - Unique user identifier - **migrationAgreementAcceptance** - Agreement acceptance flag - **clientCredentialsCreatedOnUTC** - API credentials creation timestamp - **roles** / **logins** - Arrays of user roles and login records ## Usage Notes - The response returns an array of inverter objects - Inverters with `status: 3` are currently active and available for use - Archived or deprecated inverters (`status: 5` or `6`) may still appear in results for historical reference - Curve data (`efficiencyCurves`, `kVACurves`, `pqCurves`) is typically null in list responses and must be retrieved individually if needed - User and company objects in the response are often null in list views to reduce payload size - Multiple inverters may share the same model name but have different IDs and configurations - The `lastModifiedBy` object provides full audit trail information for tracking changes ## OpenAPI ````yaml /api-docs/api-reference/plantpredict-api.yaml get /Inverter openapi: 3.1.0 info: title: PlantPredict API version: 12.13.0 description: > ## What is PlantPredict? PlantPredict is an industry-leading performance modeling platform for utility-scale solar power plants. It predicts energy yield across the full project lifecycle — from early-stage site prospecting through detailed engineering and operational monitoring. The same engine that powers the PlantPredict web UI is fully exposed via this REST API, enabling automation of complex, high-time-resolution energy predictions without any UI interaction. ## Domain Model — read this first Understanding the object hierarchy is essential before calling the API: - **Weather** — A weather file (hourly irradiance, temperature, wind, etc.) for a geographic location. Imported from a provider (e.g. SolarAnywhere, Meteonorm) or uploaded manually. Weather files live in a company-wide library and are referenced by Predictions. - **Module** — A PV module definition parameterized with electrical characteristics (STC power, temperature coefficients, single-diode model parameters, IAM curves, etc.). Modules live in a company-wide library. - **Inverter** — An inverter definition with efficiency curves, voltage/power ratings, and optional kVA derating curves. Inverters live in a company-wide library. - **Project** — A named location (lat/lon) that acts as a container for one or more Predictions. Holds geographic metadata (country, elevation, UTC offset) and a status. - **Prediction** — The core simulation configuration nested under a Project. Defines the simulation period, model selections (transposition, air mass, degradation, soiling, shading, spectral shift models), uncertainty error terms, and references to a Weather file. A Prediction must be linked to a PowerPlant before it can be run. Status values: 0 = Draft, 1 = Active, 2 = Issued, 3 = Archived. - **PowerPlant** — The physical plant design attached to a Prediction. Describes the electrical topology: Blocks → Arrays → Inverters → DC Fields (strings of modules). Also includes transformers, transmission lines, energy storage (ESS), availability losses, and LGIA export limits. - **Shade Scene** — An optional 3D shading model (PVJ format) attached to a Prediction's DC Fields. Supports import from PVC or SHD files. Shade and TABT (Tracker Angle Back-Tracking) calculations are queued and run asynchronously. ## Typical workflow to run a prediction 1. Ensure a **Weather** file exists (search, download, or import one). 2. Ensure a **Module** and **Inverter** exist in the library. 3. **POST /Project** — create a project at the site location. 4. **POST /Project/{projectId}/Prediction** — create a prediction with model settings. 5. **POST /Project/{projectId}/Prediction/{predictionId}/PowerPlant** — attach a plant design referencing your module and inverter. 6. **POST /Project/{projectId}/Prediction/{predictionId}/Run** — queue the simulation. 7. Poll **GET /Project/{projectId}/Prediction/{predictionId}/Overview** until `status` reaches 2 (complete), then retrieve results via `/ResultSummary`, `/ResultDetails`, or `/NodalJson`. ## Authentication OAuth 2.0 **Client Credentials** flow via AWS Cognito. The spec advertises a single `bearerAuth` scheme — fetch a token yourself with the snippet below, then either paste it into the in-browser playground or pass it on every request as `Authorization: Bearer `. > **Why not advertise OAuth2 directly?** Most users have access to the > production tenant only, and we don't want to invite anyone to enter > long-lived `client_id` / `client_secret` credentials into a third-party > documentation site. Keep credentials in your own environment; ship > short-lived bearer tokens to wherever they are needed. - Token URL: `https://terabase-prd.auth.us-west-2.amazoncognito.com/oauth2/token` - Scopes: `transactions/get` (read), `transactions/post` (write) — request both to access the entire surface. - Send credentials as **Basic Auth** in the token request header. Example: ```bash curl -X POST 'https://terabase-prd.auth.us-west-2.amazoncognito.com/oauth2/token' \ -u "$PP_CLIENT_ID:$PP_CLIENT_SECRET" \ -d 'grant_type=client_credentials&scope=transactions/get transactions/post' ``` API credentials (Client ID + Secret) are generated per user by a company admin inside the PlantPredict UI (gear icon → user profile → Generate API Credentials). Store them securely — they are shown only once. ## Notes - All request/response bodies are JSON (`Content-Type: application/json`). - The API is stateless — every request must supply complete inputs; there is no session. - POST operations that create entities return `{"id": }`. - Many integer fields (model types, status codes) map to named enums — use `GET /Definitions` to retrieve the full enum catalog at runtime. - Long-running operations (Run, Shade calculations, TABT) are asynchronous; poll the corresponding `ProcessingStatus` endpoint to track progress. - Responses may include an `X-Message` header with non-blocking warnings (e.g. duplicate project name). servers: - url: https://api.plantpredict.terabase.energy description: Production security: - bearerAuth: [] tags: - name: Definitions description: Enum and model type definitions - name: Projects description: Solar project management - name: Predictions description: Energy prediction configuration and execution - name: PowerPlant description: Power plant design (blocks, arrays, inverters, transformers) - name: TimeSeries description: Custom time series data inputs - name: Results description: Prediction results — summary, details, nodal, average energy - name: FinancialModel description: Financial model parameters and cashflow results - name: Reports description: Report generation and export - name: ShadeScene description: 3D shade scene management and calculations - name: Weather description: Weather file import, download, and management - name: Inverters description: Inverter library management - name: Modules description: PV module library and single-diode parameter generation - name: ASHRAE description: ASHRAE climate station lookup - name: System description: System version and maintenance status - name: Company description: Company settings and user management - name: Country description: Reference country data paths: /Inverter: get: tags: - Inverters summary: List all accessible inverters description: > # Get All Inverters Returns a list of all available Inverters in the system. ## Overview This endpoint retrieves a comprehensive list of all inverter configurations stored in the database. Each inverter entry contains detailed technical specifications, power ratings, voltage limits, efficiency curves, and metadata about ownership and modification history. ## Response Fields ### Status & Identification - **id** - Unique identifier for the inverter record - **name** - Display name of the inverter (typically includes manufacturer, model, and specifications) - **status** - Current status of the inverter record: - `2` - Active/Published - `5` - Archived - `6` - Legacy/Deprecated - **description** - Optional notes or additional information about the inverter configuration ### Manufacturer & Model Information - **manufacturer** - Inverter manufacturer name (e.g., "ABB") - **model** - Specific model identifier (e.g., "PVS800-57-1000kW-C") - **inverterType** - Classification of inverter type: - `2` - Central inverter - Other values may represent string or micro inverters ### Power Specifications - **powerRated** - Rated AC power output in kilowatts (kW) - **apparentPower** - Apparent power capacity in kilovolt-amperes (kVA) - **minDCPowerThreshold** - Minimum DC power threshold in watts (W) for operation - **outputVoltage** - AC output voltage in volts (V) ### Voltage & Current Limits - **minVoltage** - Minimum DC input voltage in volts (V) - **maxMPPVoltage** - Maximum power point tracking voltage in volts (V) - **maxAbsoluteVoltage** - Maximum absolute DC voltage limit in volts (V) - **maxCurrent** - Maximum DC input current in amperes (A) ### Environmental & Physical Constraints - **maxElevation** - Maximum operating elevation in meters above sea level ### Curve Settings & Data Configuration - **usekVACurves** - Boolean flag indicating whether kVA derating curves are enabled - **usePQCurves** - Boolean flag indicating whether power quality curves are enabled - **dataSource** - Source identifier for the inverter data: - `2` - Standard/manufacturer data - Other values may indicate custom or imported data - **efficiencyCurves** - Array of efficiency curve data points (null if not configured) - **kVACurves** - Array of kVA derating curve data (null if not configured) - **pqCurves** - Array of power quality curve data (null if not configured) ### Ownership & Company Information - **companyId** - ID of the company that owns this inverter configuration - **company** - Company object (typically null in list responses) - **ownerId** - User ID of the inverter configuration owner - **owner** - Owner user object (typically null in list responses) ### Audit & Modification Tracking - **createdDate** - ISO 8601 timestamp when the inverter was created - **lastModified** - ISO 8601 timestamp of the most recent modification - **lastModifiedById** - User ID of the person who last modified the record - **lastModifiedBy** - Detailed user object containing: - **id** - User ID - **email** - User email address - **firstName** / **lastName** - User's name - **jobTitle** - User's job title - **companyId** - User's company affiliation - **status** - User account status (0 = system account, 1 = active) - **createdDateUtc** - When the user account was created - **lastLoginDateUTC** - Most recent login timestamp - **uuid** - Unique user identifier - **migrationAgreementAcceptance** - Agreement acceptance flag - **clientCredentialsCreatedOnUTC** - API credentials creation timestamp - **roles** / **logins** - Arrays of user roles and login records ## Usage Notes - The response returns an array of inverter objects - Inverters with `status: 3` are currently active and available for use - Archived or deprecated inverters (`status: 5` or `6`) may still appear in results for historical reference - Curve data (`efficiencyCurves`, `kVACurves`, `pqCurves`) is typically null in list responses and must be retrieved individually if needed - User and company objects in the response are often null in list views to reduce payload size - Multiple inverters may share the same model name but have different IDs and configurations - The `lastModifiedBy` object provides full audit trail information for tracking changes operationId: listInverters responses: '200': description: Array of inverters content: application/json: schema: type: array items: $ref: '#/components/schemas/Inverter' examples: postman-all: value: - status: 6 model: PVS800-57-1000kW-C manufacturer: ABB powerRated: 1000 apparentPower: 1000 minDCPowerThreshold: 5000 minVoltage: 600 maxMPPVoltage: 850 maxAbsoluteVoltage: 1100 maxCurrent: 1710 maxElevation: 2000 outputVoltage: 400 usekVACurves: false usePQCurves: false dataSource: 2 efficiencyCurves: null kVACurves: null pqCurves: null inverterType: 2 id: 132 name: ABB PVS800 57 1000kW C description: null companyId: 1 company: null ownerId: 742 owner: null createdDate: '2016-08-12T21:39:16.06' lastModified: '2017-02-23T00:45:37.47' lastModifiedById: 742 lastModifiedBy: company: null companyId: 1 firstName: System lastName: Account jobTitle: System createdByUserId: null createdByUser: null status: 0 createdDateUtc: '2016-09-01T00:00:00' settings: null costCenter: null migrationAgreementAcceptance: true clientCredentialsCreatedOnUTC: null uuid: null userWeatherDownloads: null lastLoginDateUTC: null roles: [] logins: [] id: 742 normalizedUserName: null email: FS108328@FIRSTSOLAR.COM normalizedEmail: null concurrencyStamp: 976622b5-3695-43b1-84db-823499eebbf0 - status: 5 model: PVS800-57-1000kW-C manufacturer: ABB powerRated: 1000 apparentPower: 1000 minDCPowerThreshold: 5000 minVoltage: 600 maxMPPVoltage: 850 maxAbsoluteVoltage: 1100 maxCurrent: 1710 maxElevation: 2000 outputVoltage: 400 usekVACurves: false usePQCurves: false dataSource: 2 efficiencyCurves: null kVACurves: null pqCurves: null inverterType: 2 id: 711 name: ABB PVS800 57 1000kW C description: null companyId: 1 company: null ownerId: 742 owner: null createdDate: '2017-02-23T00:45:37.45' lastModified: '2017-02-23T00:45:37.45' lastModifiedById: 742 lastModifiedBy: company: null companyId: 1 firstName: System lastName: Account jobTitle: System createdByUserId: null createdByUser: null status: 0 createdDateUtc: '2016-09-01T00:00:00' settings: null costCenter: null migrationAgreementAcceptance: true clientCredentialsCreatedOnUTC: null uuid: null userWeatherDownloads: null lastLoginDateUTC: null roles: [] logins: [] id: 742 normalizedUserName: null email: FS108328@FIRSTSOLAR.COM normalizedEmail: null concurrencyStamp: c3c3e3e9-add2-4f51-b23d-fc9ad96a584a - status: 2 model: PVS800-57-1000kW-C manufacturer: ABB powerRated: 1000 apparentPower: 1000 minDCPowerThreshold: 5000 minVoltage: 600 maxMPPVoltage: 850 maxAbsoluteVoltage: 1100 maxCurrent: 1710 maxElevation: 2000 outputVoltage: 400 usekVACurves: true usePQCurves: true dataSource: 2 efficiencyCurves: null kVACurves: null pqCurves: null inverterType: 2 id: 10332 name: ABB PVS800 57 1000kW C description: This are some inverter test notes companyId: 1042 company: null ownerId: 5093 owner: null createdDate: '2025-11-21T15:24:54.293' lastModified: '2025-11-21T15:24:54.293' lastModifiedById: 5093 lastModifiedBy: company: null companyId: 1042 firstName: Jesse lastName: Milam jobTitle: Software Developer createdByUserId: 5091 createdByUser: null status: 1 createdDateUtc: '2021-09-23T19:48:03.647' settings: null costCenter: null migrationAgreementAcceptance: true clientCredentialsCreatedOnUTC: '2025-09-24T18:21:27.657' uuid: 626e7c4e-0a96-4af0-996c-c5e979c25df1 userWeatherDownloads: null lastLoginDateUTC: '2026-02-02T00:00:00' roles: [] logins: [] id: 5093 normalizedUserName: null email: jmilam@terabase.energy normalizedEmail: null concurrencyStamp: 9744b672-ed90-44f0-8b4e-ac9c2926240f - status: 2 model: PVS800-57-1000kW-C manufacturer: ABB powerRated: 1000 apparentPower: 1000 minDCPowerThreshold: 5000 minVoltage: 600 maxMPPVoltage: 850 maxAbsoluteVoltage: 1100 maxCurrent: 1710 maxElevation: 2000 outputVoltage: 400 usekVACurves: true usePQCurves: true dataSource: 2 efficiencyCurves: null kVACurves: null pqCurves: null inverterType: 2 id: 10333 name: ABB PVS800 57 1000kW C description: This are some inverter test notes companyId: 1042 company: null ownerId: 5093 owner: null createdDate: '2025-11-21T10:31:46.4' lastModified: '2025-11-21T10:31:46.4' lastModifiedById: 5093 lastModifiedBy: company: null companyId: 1042 firstName: Jesse lastName: Milam jobTitle: Software Developer createdByUserId: 5091 createdByUser: null status: 1 createdDateUtc: '2021-09-23T19:48:03.647' settings: null costCenter: null migrationAgreementAcceptance: true clientCredentialsCreatedOnUTC: '2025-09-24T18:21:27.657' uuid: 626e7c4e-0a96-4af0-996c-c5e979c25df1 userWeatherDownloads: null lastLoginDateUTC: '2026-02-02T00:00:00' roles: [] logins: [] id: 5093 normalizedUserName: null email: jmilam@terabase.energy normalizedEmail: null concurrencyStamp: 1eb43180-5df0-471a-9367-94bae3bfeefa - status: 2 model: PVS800-57-1000kW-C manufacturer: ABB powerRated: 1000 apparentPower: 1000 minDCPowerThreshold: 5000 minVoltage: 600 maxMPPVoltage: 850 maxAbsoluteVoltage: 1100 maxCurrent: 1710 maxElevation: 2000 outputVoltage: 400 usekVACurves: true usePQCurves: true dataSource: 2 efficiencyCurves: null kVACurves: null pqCurves: null inverterType: 2 id: 10334 name: ABB PVS800 57 1000kW C description: This are some inverter test notes companyId: 1042 company: null ownerId: 5093 owner: null createdDate: '2025-11-21T10:32:48.2' lastModified: '2025-11-21T10:32:48.2' lastModifiedById: 5093 lastModifiedBy: company: null companyId: 1042 firstName: Jesse lastName: Milam jobTitle: Software Developer createdByUserId: 5091 createdByUser: null status: 1 createdDateUtc: '2021-09-23T19:48:03.647' settings: null costCenter: null migrationAgreementAcceptance: true clientCredentialsCreatedOnUTC: '2025-09-24T18:21:27.657' uuid: 626e7c4e-0a96-4af0-996c-c5e979c25df1 userWeatherDownloads: null lastLoginDateUTC: '2026-02-02T00:00:00' roles: [] logins: [] id: 5093 normalizedUserName: null email: jmilam@terabase.energy normalizedEmail: null concurrencyStamp: 3c17d76b-87d8-4690-8d4c-23d1c7ecd4a6 - status: 2 model: PVS800-57-1000kW-C manufacturer: ABB powerRated: 1000 apparentPower: 1000 minDCPowerThreshold: 5000 minVoltage: 600 maxMPPVoltage: 850 maxAbsoluteVoltage: 1100 maxCurrent: 1710 maxElevation: 2000 outputVoltage: 400 usekVACurves: true usePQCurves: true dataSource: 2 efficiencyCurves: null kVACurves: null pqCurves: null inverterType: 2 id: 10335 name: ABB PVS800 57 1000kW C description: This are some inverter test notes companyId: 1042 company: null ownerId: 5093 owner: null createdDate: '2025-11-21T10:40:03.99' lastModified: '2025-11-21T10:40:03.99' lastModifiedById: 5093 lastModifiedBy: company: null companyId: 1042 firstName: Jesse lastName: Milam jobTitle: Software Developer createdByUserId: 5091 createdByUser: null status: 1 createdDateUtc: '2021-09-23T19:48:03.647' settings: null costCenter: null migrationAgreementAcceptance: true clientCredentialsCreatedOnUTC: '2025-09-24T18:21:27.657' uuid: 626e7c4e-0a96-4af0-996c-c5e979c25df1 userWeatherDownloads: null lastLoginDateUTC: '2026-02-02T00:00:00' roles: [] logins: [] id: 5093 normalizedUserName: null email: jmilam@terabase.energy normalizedEmail: null concurrencyStamp: 9a499c2e-0a9a-45a4-b096-118f1f039c8f - status: 2 model: PVS800-57-1000kW-C manufacturer: ABB powerRated: 1000 apparentPower: 1000 minDCPowerThreshold: 5000 minVoltage: 600 maxMPPVoltage: 850 maxAbsoluteVoltage: 1100 maxCurrent: 1710 maxElevation: 2000 outputVoltage: 400 usekVACurves: true usePQCurves: true dataSource: 2 efficiencyCurves: null kVACurves: null pqCurves: null inverterType: 2 id: 10336 name: ABB PVS800 57 1000kW C description: This are some inverter test notes companyId: 1042 company: null ownerId: 5093 owner: null createdDate: '2025-11-21T10:46:00.417' lastModified: '2025-11-21T10:46:00.417' lastModifiedById: 5093 lastModifiedBy: company: null companyId: 1042 firstName: Jesse lastName: Milam jobTitle: Software Developer createdByUserId: 5091 createdByUser: null status: 1 createdDateUtc: '2021-09-23T19:48:03.647' settings: null costCenter: null migrationAgreementAcceptance: true clientCredentialsCreatedOnUTC: '2025-09-24T18:21:27.657' uuid: 626e7c4e-0a96-4af0-996c-c5e979c25df1 userWeatherDownloads: null lastLoginDateUTC: '2026-02-02T00:00:00' roles: [] logins: [] id: 5093 normalizedUserName: null email: jmilam@terabase.energy normalizedEmail: null concurrencyStamp: d73e037f-4444-47b5-a299-8c257ff9767a - status: 2 model: PVS800-57-1000kW-C manufacturer: ABB powerRated: 1000 apparentPower: 1000 minDCPowerThreshold: 5000 minVoltage: 600 maxMPPVoltage: 850 maxAbsoluteVoltage: 1100 maxCurrent: 1710 maxElevation: 2000 outputVoltage: 400 usekVACurves: false usePQCurves: false dataSource: 2 efficiencyCurves: null kVACurves: null pqCurves: null inverterType: 2 id: 10370 name: ABB PVS800 57 1000kW C description: null companyId: 1042 company: null ownerId: 5094 owner: null createdDate: '2026-01-28T13:22:53.497' lastModified: '2026-01-28T13:22:53.497' lastModifiedById: 5094 lastModifiedBy: company: null companyId: 1042 firstName: Jason lastName: Jacobs jobTitle: Software Developer createdByUserId: 5091 createdByUser: null status: 1 createdDateUtc: '2021-09-23T19:49:23.147' settings: null costCenter: null migrationAgreementAcceptance: true clientCredentialsCreatedOnUTC: '2023-09-15T15:48:57.297' uuid: 83ff4266-9d81-4eff-82fd-75031b5f1dc8 userWeatherDownloads: null lastLoginDateUTC: '2026-01-30T00:00:00' roles: [] logins: [] id: 5094 normalizedUserName: null email: jjacobs@terabase.energy normalizedEmail: null concurrencyStamp: 495ee35f-64ec-40e2-933d-efd9ac84707c - status: 2 model: PVS800-57-1000kW-C manufacturer: ABB powerRated: 1000 apparentPower: 1000 minDCPowerThreshold: 5000 minVoltage: 600 maxMPPVoltage: 850 maxAbsoluteVoltage: 1100 maxCurrent: 1710 maxElevation: 2000 outputVoltage: 400 usekVACurves: true usePQCurves: true dataSource: 2 efficiencyCurves: null kVACurves: null pqCurves: null inverterType: 2 id: 9111 name: ABB PVS800 57 1000kW C description: This are some inverter test notes companyId: 1042 company: null ownerId: 5094 owner: null createdDate: '2023-01-12T14:14:44.26' lastModified: '2025-11-20T16:16:33.297' lastModifiedById: 5094 lastModifiedBy: company: null companyId: 1042 firstName: Jason lastName: Jacobs jobTitle: Software Developer createdByUserId: 5091 createdByUser: null status: 1 createdDateUtc: '2021-09-23T19:49:23.147' settings: null costCenter: null migrationAgreementAcceptance: true clientCredentialsCreatedOnUTC: '2023-09-15T15:48:57.297' uuid: 83ff4266-9d81-4eff-82fd-75031b5f1dc8 userWeatherDownloads: null lastLoginDateUTC: '2026-01-30T00:00:00' roles: [] logins: [] id: 5094 normalizedUserName: null email: jjacobs@terabase.energy normalizedEmail: null concurrencyStamp: 07239ceb-f38b-4117-92af-a989ed2f224f - status: 5 model: PVS980-58-1840kW-6 RevE manufacturer: ABB powerRated: 1840 apparentPower: 2024 minDCPowerThreshold: 10000 minVoltage: 862 maxMPPVoltage: 1500 maxAbsoluteVoltage: 1500 maxCurrent: 1925 maxElevation: 4000 outputVoltage: 608 usekVACurves: true usePQCurves: false dataSource: 6 efficiencyCurves: null kVACurves: null pqCurves: null inverterType: 2 id: 918 name: ABB PVS980-58-1840kW-6 description: null companyId: 1 company: null ownerId: 742 owner: null createdDate: '2017-03-28T16:08:33.96' lastModified: '2021-05-19T19:14:38.2' lastModifiedById: 742 lastModifiedBy: company: null companyId: 1 firstName: System lastName: Account jobTitle: System createdByUserId: null createdByUser: null status: 0 createdDateUtc: '2016-09-01T00:00:00' settings: null costCenter: null migrationAgreementAcceptance: true clientCredentialsCreatedOnUTC: null uuid: null userWeatherDownloads: null lastLoginDateUTC: null roles: [] logins: [] id: 742 normalizedUserName: null email: FS108328@FIRSTSOLAR.COM normalizedEmail: null concurrencyStamp: 545c6e6a-2675-49c3-9707-b097d802fec2 '401': $ref: '#/components/responses/Unauthorized' '500': $ref: '#/components/responses/ServerError' components: schemas: Inverter: type: object required: - name - manufacturer - model - powerRated properties: id: type: integer readOnly: true name: type: string description: type: - string - 'null' status: type: integer enum: - 0 - 1 - 2 - 3 - 4 - 5 - 6 x-enum-varnames: - Unknown - DraftPrivate - DraftShared - Active - Retired - Global - GlobalRetired description: LibraryStatusEnum model: type: string manufacturer: type: string powerRated: type: number description: kW apparentPower: type: number minDCPowerThreshold: type: number minVoltage: type: number maxMPPVoltage: type: number maxAbsoluteVoltage: type: number maxCurrent: type: number maxElevation: type: number outputVoltage: type: number usekVACurves: type: boolean usePQCurves: type: boolean dataSource: type: integer enum: - 1 - 2 - 3 - 4 - 5 - 6 - 7 x-enum-varnames: - Manufacturer - PVsyst - UniversityOfGeneva - Photon - SandiaDatabase - Custom - PlantPredict description: DataSourceType inverterType: type: integer enum: - 0 - 1 - 2 x-enum-varnames: - Unspecified - String - Central description: InverterType efficiencyCurves: type: - array - 'null' items: type: object kVACurves: type: - array - 'null' items: type: object pqCurves: type: - array - 'null' items: type: object companyId: type: integer readOnly: true ownerId: type: integer readOnly: true createdDate: type: string readOnly: true description: >- ISO-8601 datetime as returned by the PlantPredict API. May or may not include a timezone offset; treat as server-local when no offset is present. lastModified: type: string readOnly: true description: >- ISO-8601 datetime as returned by the PlantPredict API. May or may not include a timezone offset; treat as server-local when no offset is present. responses: Unauthorized: description: >- Missing or invalid bearer token. The response body is empty and no `Content-Type` header is set; the 401 status code is the only signal. Fetch a fresh token (see the **Authentication** section of the API description) and retry. ServerError: description: | Unexpected server-side error. The body is usually a plain-text message but its structure is not guaranteed — treat it as opaque diagnostic text. Common causes: database constraint violation, downstream service timeout, internal exception. Retry-safe for idempotent requests; for non-idempotent ones, verify state before retrying. content: text/plain: schema: type: string example: An error has occurred. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Pass `Authorization: Bearer ` on every request. See the **Authentication** section of the API description for how to fetch a token. ````