Resources

Solargis asynchronous JSON Time Series API serves for accessing solar and climate data. It offers multiple endpoints. The main endpoint is used to submit a request. Another endpoint is used to track the calculation status. When the calculation is successfully completed, it also provides URL to access the resulting dataset.

Requesting data

This request specifies what data you want from Solargis.

Request type: POST

Endpoint https://api.solargis.com/ts/data-request/

Request parameters overview

• site: Object with latitude (-90 to 90), longitude (-180 to 180), optional siteName
• timeStep: Enum (PT1M, PT15M, PT60M, P1D, P1M, P1Y)
• columns: Array of parameters (e.g., ["GHI", "TEMP"])
• fromDate/toDate: ISO strings (e.g., "2022-12-01"); supports AUTO_DETECT/LAST_MONTH
• utcOffset: Optional timezone offset (e.g., "+01:00")
• outputFormat: SOLARGIS_JSON, SOLARGIS_CSV
• timeAlignment: START/CENTER/END (default: CENTER)
• terrainShading: Boolean (default: false)
• environment: albedo (number/array), horizon (azimuth/height arrays)
• gtiConfiguration: mounting type/azimuth/relative spacing
• splitOutputByYear: Booleat (default:false)

Requesting status

This request specifies what status your request is in. Can be queued, processing, or success/error.

When the status ends up in the success state, you will also receive the data in a file.

Request type: GET

Endpoint: https://api.solargis.com/ts/data-request/{requestid}