{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"41554794-a68e-42d0-a88d-12d686bc27bc","name":"Adapt API v2 (Docs)","description":"This API is provided on request by the company adapt2climate SAS based in Europe.\n\nFor any inquiries please contact: [api@adapt.sh](mailto:api@adapt.sh)\n\n# Overview\n\nThis API gives you access to hour-by-hour carbon intensity data in a selection of locations.\n\n#### Forecasted carbon intensity\n\nA dedicated endpoint give you access to our own predictions of the carbon intensity based on our algorithms.\n\n#### Actuals carbon intensity\n\nA dedicated endpoint give you access to the actually realized carbon intensity based on the power production units that produced the electricity as measured by the grid.\n\n# Available Locations\n\n| **Location** | **Code** | **Perimeter** | **Forecast** | **Actual** |\n| --- | --- | --- | --- | --- |\n| Austria | at | Power grid of Austria | Yes | Yes |\n| Belgium | be | Power grid of Belgium | Yes | Yes |\n| France continentale | fr | Power grid of continental France (does not include Corsica) | Yes | Yes |\n| Germany | de | Power grid of Germany | Yes | Yes |\n| Italia | it | Power grid of Italy (including Sardinia and Sicily). | Yes | Yes |\n| Netherlands | nl | Power grid of Netherlands | Yes | Yes |\n| Spain | es | Data from Spanish Peninsular System (does not include Balearic Islands even if they’re interconnected to continental Spain since 2020). Solar generation forecasts include solar photovoltaic and solar thermal (concentrated solar). | Yes | Yes |\n| Switzerland | ch | Power grid of Switzerland | Yes | Yes |\n| Guadeloupe | gp | Power grid of inter-connected islands of Guadalupe archipelago (e.g. includes Désirade, Les Saintes and Marie-Galante, but does not include Saint Martin or Saint Barthélemy). | Yes | Not yet |\n| United Kingdom | uk | Includes Great Britain AND Northern Ireland. | Yes | Not yet |\n\n# Error Codes\n\n| **Code** | **Reason** |\n| --- | --- |\n| 400 | Invalid request (check parameters and method) |\n| 403 | Invalid credentials (check your API key) |\n| 500 | Unexpected error, please try again later or contact us ([api@adapt.sh](mailto:api@adapt.sh)) |\n\nIn case of error a \"FAILURE\" status with a detailed description is returned in the body.\n\nFor exemple in case of unsupported location the response body will be:\n\n``` json\n{ \n    \"version\": \"2.0\", \n    \"status\": \"FAILURE\", \n    \"message\": \"Unsupported location\"\n}\n\n```\n\n# Rate limit\n\nThere is no rate limit implemented at the moment. Only fair use is allowed.\n\n# Change policy\n\nWe may make changes without prior notice if the change is considered non-breaking. Ensure that your application is designed to be able to handle the following types of non-breaking changes without prior notice :\n\n*   Addition of new endpoints\n*   Addition of new methods to existing endpoints\n*   Addition of new fields in the following scenarios:\n    *   New fields in responses\n    *   New optional request fields or parameters\n    *   New required request fields that have default values\n*   Addition of a new value returned for an existing text field\n*   Changes to the order of fields returned within a response\n*   Addition of an optional request header\n*   Changes to the length of data returned within a field\n*   Changes to the overall response size\n*   Changes to error messages. We do not recommend parsing error messages to perform business logic. Instead, you should only rely on HTTP response codes and error codes.\n*   Fixes to HTTP response codes and error codes from incorrect code to correct code\n    \n\nAs our APIs evolve, we will make reasonable efforts to notify you of breaking changes in advance with sufficient time to adapt to these changes.\n\n# Authentication\n\nAPI Key `X-AUTH-TOKEN` to be used in your request header.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"20356811","team":3296481,"collectionId":"41554794-a68e-42d0-a88d-12d686bc27bc","publishedId":"Uz5CKx4B","public":true,"publicUrl":"https://documenter-api.postman.tech/view/20356811/Uz5CKx4B","privateUrl":"https://go.postman.co/documentation/20356811-41554794-a68e-42d0-a88d-12d686bc27bc","customColor":{"top-bar":"0050CA","right-sidebar":"303030","highlight":"0050CA"},"documentationLayout":"classic-double-column","customisation":null,"version":"8.10.1","publishDate":"2022-07-08T08:44:37.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{},"logos":{}},"statusCode":200},"environments":[{"name":"Adapt API (Docs)","id":"2986d248-e027-430a-b453-817589f0320d","owner":"20353214","values":[{"key":"base_url","value":"https://www.adapt.sh/api","enabled":true},{"key":"ADAPT-API-TOKEN","value":"{Enter your dedicated API token here}","enabled":true,"type":"default"},{"key":"currentdate","value":"","enabled":true,"type":"any"},{"key":"endDate","value":"","enabled":true,"type":"any"},{"key":"pastDate","value":"","enabled":true,"type":"any"}],"published":true}],"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/c7648ab791344aaa1edbb3d45621a7ffc80ea98a282ed6078108ca136af49b07","favicon":""},"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"},{"label":"Adapt API (Docs)","value":"20353214-2986d248-e027-430a-b453-817589f0320d"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/Uz5CKx4B"}