{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"90b0bef2-997e-4ae6-bc34-fda94faf8d77","name":"Solcast API Soiling Monthly Averages  (preview2-docs.solcast.com.au)","description":"Test. The Solcast API provides forecast, live and historical solar irradiance, PV power and weather data.\n\nFor more information and our complete product specifications please visit [solcast.com](https://solcast.com/).\n\n# Free Usage and Paid Subscription Options\n\n[Registration](https://toolkit.solcast.com.au/register) is free and access is instant. New users are granted a limited number of free any-location requests to each API endpoint, for testing and evaluation. See our [pricing and plans page](https://solcast.com/pricing) for details.\n\nOnce these free requests are exhausted, for most data products users can continue to make free requests to our [Unmetered Locations](https://docs.solcast.com.au/#unmetered-locations) for further API testing.\n\nTo begin using the API commercially, a paid subscription is required. For more details and to request a quote, see our [pricing and plans page](https://solcast.com/pricing).\n\n# API Authentication\n\nThe Solcast API supports multiple authentication methods using your API key.\n\nYou get your API key by registering and signing into the [Solcast API Toolkit](https://toolkit.solcast.com.au/).\n\n| Method | Description |\n| --- | --- |\n| Query String | Add the \"api_key\" query string parameter to the URL of your request.  <br>[https://api.solcast.com.au/data/forecast/radiation_and_weather?latitude=-33.8567&amp;longitude=151.2152&amp;api_key=YOUR_API_KEY](https://api.solcast.com.au/data/forecast/radiation_and_weather?latitude=-33.8567&longitude=151.2152&api_key=YOUR_API_KEY) |\n| Bearer Token | Add your API key to the authorization header of your request:  <br>`Authorization: Bearer YOUR-API-KEY` |\n| Basic | Use Basic authentication and provide your API key as the username with an empty password. For more information, see [Basic access Authentication](https://en.wikipedia.org/wiki/Basic_access_authentication) |\n| Digest | Use Digest based authentication and provide your API key as the username with an empty password. For more information, see [Digest access Authentication](https://en.wikipedia.org/wiki/Digest_access_authentication) |\n\n# Error Codes\n\n| **HTTP Code** | **Description** |\n| --- | --- |\n| 200 OK | A successful response. |\n| 202 Accepted | The request was accepted but does not include any data in the response. Refer to the message returned in the body of the response for more information. |\n| 400 Bad Request | The request may have included invalid parameters. For more information, refer to the message returned in the response's body. |\n| 401 Unauthorized | The request did not correctly include a valid API Key. Check the API Key used in the request is correct, active, and properly added to the request using one of the available authentication methods. |\n| 402 Payment Required | You may have exceeded the available transaction limit or the requested endpoint is not available on your current plan. Check the response body for the exact reason. |\n| 403 Forbidden | The request may include a parameter not available at your current subscription level. |\n| 429 Too Many Requests | The request exceeds the available rate limit at your current subscription level. |\n| 500 Internal Server Error | An internal error has prevented the request from processing. |\n\n# Response Formats\n\nAll GET endpoints support JSON, CSV and HTML response formats by one of the following methods:\n\n- \"Accept\" HTTP request header, eg \"application/json\" for JSON\n    \n- \"format\" query string, eg [https://api.solcast.com.au/data/forecast/radiation_and_weather?latitude=-33.8567&amp;longitude=151.2152&amp;format=json](https://api.solcast.com.au/data/forecast/radiation_and_weather?latitude=-33.8567&longitude=151.2152&format=json) for JSON\n    \n- Endpoint suffix file extension, eg [https://api.solcast.com.au/data/forecast/radiation_and_weather.json?latitude=-33.8567&amp;longitude=151.2152](https://api.solcast.com.au/data/forecast/radiation_and_weather.json?latitude=-33.8567&longitude=151.2152) for JSON\n    \n\nExploration of data can use any of these data formats; however, we recommend only using JSON formats for integrations. Some endpoints support additional formats where necessary for 3rd party integration.\n\n**Common Response Formats**\n\n| **Response Format** | **Accept HTTP Header Content Type** | **Query String Method** | **Description** |\n| --- | --- | --- | --- |\n| HTML (default) | text/html | undefined, or format=html | HTML is the default response format if no option is specified. |\n| JSON | application/json | format=json | Standard JSON format |\n| CSV | text/csv | format=csv | Comma Separated Values plain text file. |\n\n# Rate Limits\n\nThe enforced rate limit is determined by the product type and your active product plan. You can check your rate limit in the [Solcast API Toolkit](https://toolkit.solcast.com.au/account/subscription).\n\nIf a request exceeds the defined rate limit, it is rejected with the HTTP 429 Too Many Requests response.\n\nFor those with very high volume data requirements, please reach out to the Solcast team and we may grant access to an increased rate limit depending on the use case.\n\n# Unmetered Locations\n\nThese are selected locations that can be used when testing or evaluating data. Requests for data using **the** _**exact**_ **latitude and longitude combinations** listed here will not reduce your number of available transactions.\n\nPlease note:\n\n1. The required precision to match an Unmetered Location latitude and longitude has been reduced to four decimal places.\n    \n2. The Unmetered Locations are not available for the Legacy products including Weather Sites, Utility Scale Sites, Rooftop Sites and World API.\n    \n\n| Location | Latitude | Longitude | Advanced PV Power Resource ID |\n| --- | --- | --- | --- |\n| Sydney Opera House | \\-33.8567 | 151.2152 | ba75-e17a-7374-95ed |\n| Grand Canyon | 36.0997 | \\-112.1124 | 375f-eb3e-71c0-ef5e |\n| Stonehenge | 51.1788 | \\-1.8262 | 1a57-6b1f-ec18-c5c8 |\n| The Colosseum | 41.8902 | 12.4922 | 5f86-4c8f-2cb3-0215 |\n| Giza Pyramid Complex | 29.9772 | 31.1324 | 8d10-f530-af85-5cbb |\n| Taj Mahal | 27.1751 | 78.0421 | b926-8fd2-ad3f-e4f5 |\n| Fort Peck ([SURFRAD](https://gml.noaa.gov/grad/surfrad/ftpeck.html)) | 48.3078 | \\-105.1017 | 3ae7-2456-492c-9aba |\n| Goodwin Creek ([SURFRAD](https://gml.noaa.gov/grad/surfrad/goodwin.html)) | 34.2547 | \\-89.8729 | b787-cf17-e429-ef1d |\n\n# Weather Type Parameter\n\nThe weather_type parameter specifies the general weather condition for the requested location and time. It contains a predefined set of simple, easy-to-understand categories that represent common weather scenarios. This parameter helps users quickly identify the expected weather without needing detailed meteorological data. The common use-case for weather_type is to show weather icons.\n\n| **Weather Type** | **Description** |\n| --- | --- |\n| DAMAGING WIND | Winds strong enough to cause damage |\n| THUNDERSTORM | Thunderstorm with rain falling |\n| BLOWING SNOW | Falling snow being blown by the wind |\n| RAIN | Rain falling |\n| INTERMITTENT RAIN | Periods of rain and no rain |\n| MIXED PRECIPITATION | Mix of frozen and liquid precipitation |\n| SNOW | Snow falling |\n| DRIZZLE | Drizzle falling |\n| WINDY | Windy conditions |\n| FOG | Foggy conditions |\n| FROST | Cold, clear and still conditions conducive to formation of frost on exposed surfaces |\n| OVERCAST | Overcast sky |\n| MOSTLY CLOUDY | Mostly cloudy sky |\n| PARTLY CLOUDY | Partly cloudy sky |\n| HAZY | Hazy sky |\n| MOSTLY SUNNY | Few clouds and sun is up |\n| MOSTLY CLEAR | Few clouds and sun is set |\n| SUNNY | Clear sky and sun is up |\n| CLEAR | Clear sky and sun is set |\n\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"12706422","team":1266419,"collectionId":"90b0bef2-997e-4ae6-bc34-fda94faf8d77","publishedId":"2sBXcKBdcb","public":true,"publicUrl":"https://preview2-docs.solcast.com.au","privateUrl":"https://go.postman.co/documentation/12706422-90b0bef2-997e-4ae6-bc34-fda94faf8d77","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2026-03-03T21:40:34.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/8b5667a17b564bf2d4d856ea1eb8a5dc724ff355c8c5f04f6c520c1714e0768f","favicon":"https://res.cloudinary.com/postman/image/upload/v1600051406/team/eto3tl0em2kg3smtxzma.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://preview2-docs.solcast.com.au/view/metadata/2sBXcKBdcb"}