Introduction

Solargis API documentation

Solargis API is designed for solar project developers, analysts, consultants, and system integrators who require precise solar and meteorological data for a variety of applications.

Our platform offers several API endpoints and data delivery methods, accommodating various scenarios. Each API relates to a Solargis product, and is described below together with links to the related product documentation and the API technical guides. For a business-level overview of all API services, see Solargis API data services.

Getting started

To start using Solargis APIs, you need to:

Have a Solargis account with an active API subscription. You can purchase an API subscription by contacting us directly or reaching out to your account manager.
Obtain an API authentication token - required for every API request call.
Optionally, test the endpoints directly in the API documentation using the API console.

APIs by product

Solargis Monitor & Forecast

Related product documentation: Introduction to Monitor, Introduction to Forecast

Solargis Monitor & Forecast API endpoint- lets you download Solargis Monitor and Forecast time series data using the synchronous method, suitable for monitoring and forecasting applications. This API uses XML format for communication. Links to related documentation:
- Solargis Monitor API and Solargis Forecast API service introductions
- Monitor and Forecast subscription parameters
- Technical guide
Push Delivery for Solargis Monitor & Forecast- automates the delivery of Solargis Monitor and Forecast datasets in CSV format directly to your remote SFTP folder at regular intervals. You define your locations and parameters in a data request file, and Solargis sets up the delivery for you. Suitable for large-scale monitoring and forecasting setups. Links to related documentation:
- Technical guide

To explore the data coverage for these services, view data coverage maps for Monitor and Forecast.

Solargis Prospect

Related product documentation: Introduction to Prospect

Solargis Long-term averages (LTA) API endpoint- similar to the Solargis Monitor & Forecast endpoint. Uses XML for communication and lets you download Long-term averages (LTA) data using the synchronous method. Links to related documentation:
- Long-term averages API service introduction
- LTA API subscription details
- Technical guide

To view the data coverage for various regions, see the Prospect data coverage map.

Solargis Evaluate

Related product documentation: Introduction to Evaluate

Solargis Time Series and TMY API endpoints - dedicated to downloading Solargis Time Series (TS) and Typical Meteorological Year(TMY) data for specific locations, using the asynchronous method and JSON format. The TMY data is also suitable for usage in 3rd-party applications such as PVsyst. Links to related documentation:
- Time Series and TMY API service introduction
- Time Series and TMY API subscription details
- Time Series integration guide and technical guide
- TMY integration guide and technical guide
- Python code example on how to integrate the async Time Series API on our GitHub

Each data type has a dedicated API endpoint. The types of data you can access and the level of detail (granularity) depend on your API subscription plan. When setting up your integration for the first time, take advantage of our free integration setup endpoints, which you can use for test calls while building your integration. The setup guide is provided in the respective integration setup document of each API.

To view the data coverage for various regions, see the Evaluate data coverage map.

Note:

The Solargis Time Series and TMY data APIs operate asynchronously. This means that when you submit a data request, the API does not return the results immediately. Instead, the initial request registers your query, and you must perform a follow-up call to check the status of the calculation and retrieve your data once processing is complete. This asynchronous workflow is designed to handle potentially large and complex data queries efficiently, allowing you to track progress and download results when they are ready.

Solargis PV components catalog

Related product documentation: Introduction to the catalog

PV components catalog API endpoints- use these endpoints to access PV modules, inverters, and batteries from the PV components catalog, and the related codebook values. Links to related documentation:
- Catalog API access and Solargis Evaluate connection (API key generation)
- Technical guides: PV Components and Codebook endpoints

Solargis account

Subscription details API endpoint- use this endpoint to download information about your API subscription and usage history. Calls to this endpoint are free of charge. Links to related documentation:
- Technical guide

Technical specification

Field	Value / Description
Type	Asynchronous REST API (Solargis Time Series and TMY APIs) Synchronous API (Solargis LTA and Solargis Monitor & Forecast APIs) Scheduled file delivery to SFTP (Push Delivery for Solargis Monitor & Forecast)
Format	JSON (Time Series and TMY) XML (Monitor, Forecast, and LTA) CSV (Push Delivery for Monitor & Forecast)
Authentication	API token PV components catalog API: catalog API key
Endpoints	Separate endpoints for: Solargis Time Series API Solargis TMY API Solargis LTA API Solargis Monitor & Forecast API Push Delivery for Solargis Monitor & Forecast PV components catalog API Subscription details
Time Resolution	1-minute, 15-minute, hourly, daily, monthly, yearly (depending on the API and subscription plan)
Geographic Coverage	Global (excluding polar regions)
Historical data	Available from 1994 to the present, depending on the region
Subscription plans and parameters	Time Series - Yearly, Monthly, Daily, Hourly and 15-minute, 1-minute, Enterprise TMY - Hourly, 15-minute, 1-minute Monitor - Basic, Professional/Enterprise, Real-time Forecast - Basic, Professional/Enterprise, Historical period, Portfolio aggregation Long-term averages
Rate Limits	Defined by subscription; usage tracked via custom HTTP headers
Supported Use Cases	Feasibility analysis, site assessment, PV system design, performance benchmarking, monitoring, forecasting
Integration	Designed for automated integration with PV simulation and monitoring platforms
Error Handling	Standard HTTP status codes and error messages