{"openapi":"3.1.2","info":{"title":"meteoblue Time API","description":"# Overview\n\nThe Time API provides information about the available timestamps for weather map data used in the Maps API and Tiles API.\nIt allows users to retrieve the temporal structure of datasets, including available dates and time steps for specific domains and layers.\nWeather data is inherently time-dependent, and not all timestamps are available for every dataset or location.\nThe Time API enables users to query valid time values in advance, ensuring that subsequent requests to map or tile endpoints use supported timestamps.\nThe API is designed to support applications that require time-aware visualisations, such as interactive maps or time-based animations.\nBy retrieving available timestamps, users can synchronise map layers, build time sliders, or iterate through forecast and observation data in a consistent way.\n\nLearn more about the features and use cases of the [Maps API](https://business.meteoblue.com/products/weather-apis/weather-maps-api) on our website.\nConfigure and send API requests using the [Maps API Configurator](https://www.meteoblue.com/en/weather-api/maps-api/).\n\n## Credits and Call Limits\n\n### Usage Accounting and Limits\n\nRequests to the Time API do not consume any credits.\n\n**Without further agreement, we impose a rate limit of 500 calls per minute.** If you plan to make a lot of requests, please evenly distribute your calls over a few hours.","version":"1.0.0","x-logo":{"url":"https://static.meteoblue.com/assets/images/logo/meteoblue_logo_v2.0.png","backgroundColor":"hsl(210deg, 40%, 98%)","altText":"meteoblue","href":"https://docs.meteoblue.com/en/weather-apis/introduction/overview"}},"tags":[{"name":"Recent Timesteps","description":"Hourly, daily, monthly, next-hours, and last-hours timestamps for a domain's current forecast data."},{"name":"Historic Timesteps","description":"Archived hourly, daily, monthly, and next-hours timestamps for a domain."},{"name":"Radar & Satellite Timesteps","description":"Archived timestamps for radar and satellite tilesets, queried over a `start`/`end` range."}],"servers":[{"url":"https://maps-api.meteoblue.com"}],"security":[{"apikey":[]}],"paths":{"/v1/time/hourly/{domain}":{"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","enum":["NEMS4","NEMS12","NEMSGLOBAL","GFS05","GFS025","GFS012","MFEU","MFGLOBAL","UMGLOBAL","ICON","ICONEU"]},"description":"Domain (Weather-Model) from which to get the data."}],"get":{"tags":["Recent Timesteps"],"summary":"Hourly Timestamps","description":"The `Time API` endpoints provide access to available timestamps for weather map data.\nThey allow users to retrieve valid time values that can be used when requesting map or tile data.\nThis endpoint returns the available hourly timestamps for a specified domain.\nThe response provides a list of valid time steps that can be used when requesting tile or map data.\nThese timestamps represent the available temporal resolution of the underlying dataset and ensure that subsequent requests use supported values.\nThe endpoint is typically used to retrieve valid time values before requesting tiles or maps,\nfor example when building time-based visualisations or iterating through forecast or observational data and can be used to show non aggregated maps with an hourly or 3-hourly (depending on the domain) resolution.\n\nExample map: [Temperature 3-hourly](https://www.meteoblue.com/en/weather/maps/basel_switzerland_2661604#coords=4/47.56/7.57&map=temperature~hourly~auto~2%20m%20above%20gnd~none)","responses":{"200":{"description":"OK","headers":{"MB-Credits-Accounted":{"$ref":"#/components/headers/accounting-header"}},"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","const":"regular"},"first":{"type":"string","description":"The timestamp of the first available timestep.","examples":["2026-03-19T00:00"]},"current":{"type":"string","description":"The timestamp of the current timestep.","examples":["2026-03-19T09:00"]},"last":{"type":"string","description":"The timestamp of the last available timestep.","examples":["2026-03-22T00:00"]},"interval":{"type":"integer","description":"The interval between two timesteps in seconds.","examples":[3600,10800]},"lastUpdate":{"type":"string","description":"The timestamp of the last update. This can be used for cache invalidation.","examples":["2026-03-19T05:57:17"]},"expires":{"type":"string","description":"At this point in time the map should be reloaded.","examples":["2026-03-19T10:31:54"]}},"required":["type","first","current","last","interval","lastUpdate","expires"]}}}},"400":{"$ref":"#/components/responses/error-response","description":"Bad Request"},"403":{"$ref":"#/components/responses/error-response","description":"Forbidden"},"429":{"$ref":"#/components/responses/error-response","description":"Too Many Requests"}},"x-codeSamples":[{"lang":"JavaScript","source":"fetch(\"https://maps-api.meteoblue.com/v1/time/hourly/NEMSGLOBAL?apikey=YOUR_APIKEY\")\n.then(res => res.json())\n.then(console.log);"},{"lang":"Python","source":"import requests\n\nurl = f\"https://maps-api.meteoblue.com/v1/time/hourly/NEMSGLOBAL?apikey=YOUR_APIKEY\"\nresponse = requests.get(url)\nprint(response.json())"},{"lang":"Shell","source":"curl \"https://maps-api.meteoblue.com/v1/time/hourly/NEMSGLOBAL?apikey=YOUR_APIKEY\""},{"lang":"Java","source":"import java.net.*;\nimport java.io.*;\n\npublic class Main {\n    public static void main(String[] args) throws Exception {\n        String url = \"https://maps-api.meteoblue.com/v1/time/hourly/NEMSGLOBAL?apikey=YOUR_APIKEY\";\n        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();\n        conn.setRequestMethod(\"GET\");\n\n        try (BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()))) {\n            String line;\n            while ((line = in.readLine()) != null) {\n                System.out.println(line);\n            }\n        }\n    }\n}"}]}},"/v1/time/daily/{domain}":{"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","enum":["NEMS4","NEMS12","NEMSGLOBAL","GFS05","GFS025","GFS012","MFEU","MFGLOBAL","UMGLOBAL","ICON","ICONEU"]},"description":"Domain (Weather-Model) from which to get the data."},{"name":"lang","in":"query","schema":{"type":"string","enum":["ar","bg","cs","de","da","el","en","es","fr","hu","it","ja","ka","ko","nl","pl","pt","ro","ru","sk","sl","sr","sv","tr","zh","th","uk","hr","ca","fi","id","no","vi"],"default":"en","x-enumDescriptions":{"ar":"Arabic","bg":"Bulgarian","cs":"Czech","de":"German","da":"Danish","el":"Greek","en":"English","es":"Spanish","fr":"French","hu":"Hungarian","it":"Italian","ja":"Japanese","ka":"Georgian","ko":"Korean","nl":"Dutch","pl":"Polish","pt":"Portuguese","ro":"Romanian","ru":"Russian","sk":"Slovak","sl":"Slovene","sr":"Serbian","sv":"Swedish","tr":"Turkish","zh":"Chinese (Simplified)","th":"Thai","uk":"Ukranian","hr":"Croatian","ca":"Catalan","fi":"Finnish","id":"Indonesian","no":"Norwegian","vi":"Vietnamese"}},"description":"Language to use for localisation purposes."}],"get":{"tags":["Recent Timesteps"],"summary":"Daily Timestamps","description":"This endpoint returns the available daily timestamps for a specified domain.\nThe response provides a list of valid daily time steps that can be used when requesting tile or map data. These timestamps represent the available daily temporal resolution of the underlying dataset and help ensure that subsequent requests use supported values.\nThe endpoint is typically used to retrieve valid daily time values before requesting tiles or maps, for example when building day-based visualisations or iterating through forecast or observational data.\n\nExample map: [Temperature Daily Max](https://www.meteoblue.com/en/weather/maps/basel_switzerland_2661604#coords=4/47.56/7.57&map=temperature~daily-max~auto~2%20m%20above%20gnd~none)","responses":{"200":{"description":"OK","headers":{"MB-Credits-Accounted":{"$ref":"#/components/headers/accounting-header"}},"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","const":"categories"},"categories":{"type":"array","description":"List of categories","examples":[[{"name":"Thu 19","value":"2026-03-19TZ"},{"name":"Fri 20","value":"2026-03-20TZ"},{"name":"Sat 21","value":"2026-03-21TZ"}]],"items":{"type":"object","properties":{"name":{"type":"string","description":"Name of the category, useful for displaying in interfaces.","examples":["Thu 19"]},"value":{"type":"string","description":"Value of the category, used to make queries for actual data.","examples":["2026-03-19TZ"]}},"required":["name","value"]},"uniqueItems":true},"lastUpdate":{"type":"string","description":"The timestamp of the last update. This can be used for cache invalidation.","examples":["2026-03-19T05:57:17"]},"expires":{"type":"string","description":"At this point in time the map should be reloaded.","examples":["2026-03-19T10:31:54"]}},"required":["type","categories","lastUpdate","expires"]}}}},"400":{"$ref":"#/components/responses/error-response","description":"Bad Request"},"403":{"$ref":"#/components/responses/error-response","description":"Forbidden"},"429":{"$ref":"#/components/responses/error-response","description":"Too Many Requests"}},"x-codeSamples":[{"lang":"JavaScript","source":"fetch(\"https://maps-api.meteoblue.com/v1/time/daily/NEMSGLOBAL?apikey=YOUR_APIKEY\")\n.then(res => res.json())\n.then(console.log);"},{"lang":"Python","source":"import requests\n\nurl = f\"https://maps-api.meteoblue.com/v1/time/daily/NEMSGLOBAL?apikey=YOUR_APIKEY\"\nresponse = requests.get(url)\nprint(response.json())"},{"lang":"Shell","source":"curl \"https://maps-api.meteoblue.com/v1/time/daily/NEMSGLOBAL?apikey=YOUR_APIKEY\""},{"lang":"Java","source":"import java.net.*;\nimport java.io.*;\n\npublic class Main {\n    public static void main(String[] args) throws Exception {\n        String url = \"https://maps-api.meteoblue.com/v1/time/daily/NEMSGLOBAL?apikey=YOUR_APIKEY\";\n        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();\n        conn.setRequestMethod(\"GET\");\n\n        try (BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()))) {\n            String line;\n            while ((line = in.readLine()) != null) {\n                System.out.println(line);\n            }\n        }\n    }\n}"}]}},"/v1/time/monthly/{domain}":{"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","enum":["NEMS4","NEMS12","NEMSGLOBAL","GFS05","GFS025","GFS012","MFEU","MFGLOBAL","UMGLOBAL","ICON","ICONEU"]},"description":"Domain (Weather-Model) from which to get the data."}],"get":{"tags":["Recent Timesteps"],"summary":"Monthly Timestamps","description":"This endpoint returns the available monthly timestamps for a specified domain.\nThe response provides a list of valid monthly time steps that can be used when requesting tile or map data. These timestamps represent the available monthly temporal resolution of the underlying dataset and help ensure that subsequent requests use supported values.\nThe endpoint is typically used to retrieve valid monthly time values before requesting tiles or maps, for example when building long-term visualisations or iterating through aggregated forecast or observational data.\n\nExample map: [Wind Speed Anomaly](https://www.meteoblue.com/en/weather/maps/basel_switzerland_2661604#coords=4/47.56/7.57&map=windSpeedAnomaly~monthly~auto~sfc~none)","responses":{"200":{"description":"OK","headers":{"MB-Credits-Accounted":{"$ref":"#/components/headers/accounting-header"}},"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","const":"categories"},"categories":{"type":"array","description":"List of categories","examples":[[{"name":"2026-03","value":"2026-03-01"},{"name":"2026-04","value":"2026-04-01"},{"name":"2026-05","value":"2026-05-01"}]],"items":{"type":"object","properties":{"name":{"type":"string","description":"Name of the category, useful for displaying in interfaces.","examples":["2026-03"]},"value":{"type":"string","description":"Value of the category, used to make queries for actual data.","examples":["2026-03-01"]}},"required":["name","value"]},"uniqueItems":true},"lastUpdate":{"type":"string","description":"The timestamp of the last update. This can be used for cache invalidation.","examples":["2026-03-15T07:10:27"]},"expires":{"type":"string","description":"At this point in time the map should be reloaded.","examples":["2026-03-19T10:58:35"]}},"required":["type","categories","lastUpdate","expires"]}}}},"400":{"$ref":"#/components/responses/error-response","description":"Bad Request"},"403":{"$ref":"#/components/responses/error-response","description":"Forbidden"},"429":{"$ref":"#/components/responses/error-response","description":"Too Many Requests"}},"x-codeSamples":[{"lang":"JavaScript","source":"fetch(\"https://maps-api.meteoblue.com/v1/time/monthly/SA-ENSEMBLE?apikey=YOUR_APIKEY\")\n.then(res => res.json())\n.then(console.log);"},{"lang":"Python","source":"import requests\n\nurl = f\"https://maps-api.meteoblue.com/v1/time/monthly/SA-ENSEMBLE?apikey=YOUR_APIKEY\"\nresponse = requests.get(url)\nprint(response.json())"},{"lang":"Shell","source":"curl \"https://maps-api.meteoblue.com/v1/time/monthly/SA-ENSEMBLE?apikey=YOUR_APIKEY\""},{"lang":"Java","source":"import java.net.*;\nimport java.io.*;\n\npublic class Main {\n    public static void main(String[] args) throws Exception {\n        String url = \"https://maps-api.meteoblue.com/v1/time/monthly/SA-ENSEMBLE?apikey=YOUR_APIKEY\";\n        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();\n        conn.setRequestMethod(\"GET\");\n\n        try (BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()))) {\n            String line;\n            while ((line = in.readLine()) != null) {\n                System.out.println(line);\n            }\n        }\n    }\n}"}]}},"/v1/time/nexthours/{domain}":{"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","enum":["NEMS4","NEMS12","NEMSGLOBAL","GFS05","GFS025","GFS012","MFEU","MFGLOBAL","UMGLOBAL","ICON","ICONEU"]},"description":"Domain (Weather-Model) from which to get the data."},{"name":"lang","in":"query","schema":{"type":"string","enum":["ar","bg","cs","de","da","el","en","es","fr","hu","it","ja","ka","ko","nl","pl","pt","ro","ru","sk","sl","sr","sv","tr","zh","th","uk","hr","ca","fi","id","no","vi"],"default":"en","x-enumDescriptions":{"ar":"Arabic","bg":"Bulgarian","cs":"Czech","de":"German","da":"Danish","el":"Greek","en":"English","es":"Spanish","fr":"French","hu":"Hungarian","it":"Italian","ja":"Japanese","ka":"Georgian","ko":"Korean","nl":"Dutch","pl":"Polish","pt":"Portuguese","ro":"Romanian","ru":"Russian","sk":"Slovak","sl":"Slovene","sr":"Serbian","sv":"Swedish","tr":"Turkish","zh":"Chinese (Simplified)","th":"Thai","uk":"Ukranian","hr":"Croatian","ca":"Catalan","fi":"Finnish","id":"Indonesian","no":"Norwegian","vi":"Vietnamese"}},"description":"Language to use for localisation purposes."}],"get":{"tags":["Recent Timesteps"],"summary":"Next Hours","description":"This endpoint returns the available timestamps for the next forecast hours for a specified domain.\nThe response provides a list of valid short-range future time steps that can be used when requesting tile or map data. These timestamps represent the immediately available forecast horizon of the underlying dataset and help ensure that subsequent requests use supported values.\nThe endpoint is typically used to retrieve upcoming valid time values before requesting tiles or maps, for example when building short-term forecast visualisations, animations, or time-based navigation for near-future weather data.\n\nExample map: [Accumulated Precipitation](https://www.meteoblue.com/en/weather/maps/basel_switzerland_2661604#coords=4/47.56/7.57&map=precipitationAccumulated~accumulated-hourly~auto~sfc~none)","responses":{"200":{"description":"OK","headers":{"MB-Credits-Accounted":{"$ref":"#/components/headers/accounting-header"}},"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","const":"categories"},"categories":{"type":"array","description":"List of categories","examples":[[{"name":"Next 6h","value":"2026-03-19T10:00%2F2026-03-19T16:00"},{"name":"Next 12h","value":"2026-03-19T10:00%2F2026-03-19T22:00"},{"name":"Next 18h","value":"2026-03-19T10:00%2F2026-03-20T04:00"}]],"items":{"type":"object","properties":{"name":{"type":"string","description":"Name of the category, useful for displaying in interfaces.","examples":["Next 6h"]},"value":{"type":"string","description":"Value of the category, used to make queries for actual data.","examples":["2026-03-19T10:00%2F2026-03-19T16:00"]}},"required":["name","value"]},"uniqueItems":true},"lastUpdate":{"type":"string","description":"The timestamp of the last update. This can be used for cache invalidation.","examples":["2026-03-15T07:10:27"]},"expires":{"type":"string","description":"At this point in time the map should be reloaded.","examples":["2026-03-19T10:58:35"]}},"required":["type","categories","lastUpdate","expires"]}}}},"400":{"$ref":"#/components/responses/error-response","description":"Bad Request"},"403":{"$ref":"#/components/responses/error-response","description":"Forbidden"},"429":{"$ref":"#/components/responses/error-response","description":"Too Many Requests"}},"x-codeSamples":[{"lang":"JavaScript","source":"fetch(\"https://maps-api.meteoblue.com/v1/time/nexthours/NEMSGLOBAL?apikey=YOUR_APIKEY\")\n.then(res => res.json())\n.then(console.log);"},{"lang":"Python","source":"import requests\n\nurl = f\"https://maps-api.meteoblue.com/v1/time/nexthours/NEMSGLOBAL?apikey=YOUR_APIKEY\"\nresponse = requests.get(url)\nprint(response.json())"},{"lang":"Shell","source":"curl \"https://maps-api.meteoblue.com/v1/time/nexthours/NEMSGLOBAL?apikey=YOUR_APIKEY\""},{"lang":"Java","source":"import java.net.*;\nimport java.io.*;\n\npublic class Main {\n    public static void main(String[] args) throws Exception {\n        String url = \"https://maps-api.meteoblue.com/v1/time/nexthours/NEMSGLOBAL?apikey=YOUR_APIKEY\";\n        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();\n        conn.setRequestMethod(\"GET\");\n\n        try (BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()))) {\n            String line;\n            while ((line = in.readLine()) != null) {\n                System.out.println(line);\n            }\n        }\n    }\n}"}]}},"/v1/time/lasthours/{domain}":{"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","enum":["NEMS4","NEMS12","NEMSGLOBAL","GFS05","GFS025","GFS012","MFEU","MFGLOBAL","UMGLOBAL","ICON","ICONEU"]},"description":"Domain (Weather-Model) from which to get the data."},{"name":"lang","in":"query","schema":{"type":"string","enum":["ar","bg","cs","de","da","el","en","es","fr","hu","it","ja","ka","ko","nl","pl","pt","ro","ru","sk","sl","sr","sv","tr","zh","th","uk","hr","ca","fi","id","no","vi"],"default":"en","x-enumDescriptions":{"ar":"Arabic","bg":"Bulgarian","cs":"Czech","de":"German","da":"Danish","el":"Greek","en":"English","es":"Spanish","fr":"French","hu":"Hungarian","it":"Italian","ja":"Japanese","ka":"Georgian","ko":"Korean","nl":"Dutch","pl":"Polish","pt":"Portuguese","ro":"Romanian","ru":"Russian","sk":"Slovak","sl":"Slovene","sr":"Serbian","sv":"Swedish","tr":"Turkish","zh":"Chinese (Simplified)","th":"Thai","uk":"Ukranian","hr":"Croatian","ca":"Catalan","fi":"Finnish","id":"Indonesian","no":"Norwegian","vi":"Vietnamese"}},"description":"Language to use for localisation purposes."}],"get":{"tags":["Recent Timesteps"],"summary":"Last Hours","description":"This endpoint returns the available timestamps for the most recent past hours for a specified domain.\nThe response provides a list of valid recent time steps that can be used when requesting tile or map data.\nThese timestamps represent the latest available observation or recent forecast data from the underlying dataset and help ensure that subsequent requests use supported values.\nThe endpoint is typically used to retrieve recent valid time values before requesting tiles or maps, for example when visualising recent weather developments, creating playback animations, or analysing short-term historical conditions.\n\nExample map: [Last Days Precipitation](https://www.meteoblue.com/en/weather/maps/basel_switzerland_2661604#coords=4/47.56/7.57&map=precipitationAccumulatedPastHours~accumulated-hourly~auto~sfc~none)","responses":{"200":{"description":"OK","headers":{"MB-Credits-Accounted":{"$ref":"#/components/headers/accounting-header"}},"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","const":"categories"},"categories":{"type":"array","description":"List of categories","examples":[[{"name":"2026-03-23 00 UTC","value":"2026-03-22T23:00%2F2026-03-23T00:00"},{"name":"Last 6h","value":"2026-03-22T18:00%2F2026-03-23T00:00"},{"name":"Last 12h","value":"2026-03-22T12:00%2F2026-03-23T00:00"}]],"items":{"type":"object","properties":{"name":{"type":"string","description":"Name of the category, useful for displaying in interfaces.","examples":["2026-03-23 00 UTC","Last 6h","Last 12h"]},"value":{"type":"string","description":"Value of the category, used to make queries for actual data.","examples":["2026-03-22T23:00%2F2026-03-23T00:00"]}},"required":["name","value"]},"uniqueItems":true},"lastUpdate":{"type":"string","description":"The timestamp of the last update. This can be used for cache invalidation.","examples":["2026-03-15T07:10:27"]},"expires":{"type":"string","description":"At this point in time the map should be reloaded.","examples":["2026-03-19T10:58:35"]}},"required":["type","categories","lastUpdate","expires"]}}}},"400":{"$ref":"#/components/responses/error-response","description":"Bad Request"},"403":{"$ref":"#/components/responses/error-response","description":"Forbidden"},"429":{"$ref":"#/components/responses/error-response","description":"Too Many Requests"}},"x-codeSamples":[{"lang":"JavaScript","source":"fetch(\"https://maps-api.meteoblue.com/v1/time/lasthours/NEMSGLOBAL?apikey=YOUR_APIKEY\")\n.then(res => res.json())\n.then(console.log);"},{"lang":"Python","source":"import requests\n\nurl = f\"https://maps-api.meteoblue.com/v1/time/lasthours/NEMSGLOBAL?apikey=YOUR_APIKEY\"\nresponse = requests.get(url)\nprint(response.json())"},{"lang":"Shell","source":"curl \"https://maps-api.meteoblue.com/v1/time/lasthours/NEMSGLOBAL?apikey=YOUR_APIKEY\""},{"lang":"Java","source":"import java.net.*;\nimport java.io.*;\n\npublic class Main {\n    public static void main(String[] args) throws Exception {\n        String url = \"https://maps-api.meteoblue.com/v1/time/lasthours/NEMSGLOBAL?apikey=YOUR_APIKEY\";\n        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();\n        conn.setRequestMethod(\"GET\");\n\n        try (BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()))) {\n            String line;\n            while ((line = in.readLine()) != null) {\n                System.out.println(line);\n            }\n        }\n    }\n}"}]}},"/v1/time/hourly_history/{domain}":{"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","enum":["NEMS4","NEMS12","NEMSGLOBAL","GFS05","GFS025","GFS012","MFEU","MFGLOBAL","UMGLOBAL","ICON","ICONEU"]},"description":"Domain (Weather-Model) from which to get the data."},{"name":"start","in":"query","required":true,"schema":{"type":"string","format":"date-time","examples":["2025-01-01T00:00:00Z","2025-01-01"],"pattern":"(?:19|20|21)\\d\\d-?\\d\\d-?\\d\\d(T\\d\\d(:\\d\\d(:\\d\\d)?)?)?Z?"},"description":"Start of timerange of interest."}],"get":{"tags":["Historic Timesteps"],"summary":"Hourly Timestamps (Historic)","description":"This endpoint returns the available hourly timestamps for historical data of a specified domain.\nThe response provides a list of valid time steps that can be used when requesting tile or map data. These timestamps represent the available temporal resolution of the underlying dataset and ensure that subsequent requests use supported values.\nThe endpoint is typically used to retrieve valid historical time values before requesting tiles or maps, for example when visualising past weather conditions with an hourly or 3-hourly (depending on the domain) resolution.","responses":{"200":{"description":"OK","headers":{"MB-Credits-Accounted":{"$ref":"#/components/headers/accounting-header"}},"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","const":"regular"},"first":{"type":"string","description":"The timestamp of the first available timestep, equal to `start`.","examples":["2025-01-01T00:00"]},"last":{"type":"string","description":"The timestamp of the last available timestep, `start` plus 7 days.","examples":["2025-01-08T00:00"]},"interval":{"type":"integer","description":"The interval between two timesteps in seconds.","examples":[3600,10800]},"lastUpdate":{"type":["string","null"],"description":"The timestamp of the last update. This can be used for cache invalidation.","examples":[null]},"expires":{"type":["string","null"],"description":"At this point in time the map should be reloaded.","examples":[null]}},"required":["type","first","last","interval","lastUpdate","expires"]}}}},"400":{"$ref":"#/components/responses/error-response","description":"Bad Request"},"403":{"$ref":"#/components/responses/error-response","description":"Forbidden"},"429":{"$ref":"#/components/responses/error-response","description":"Too Many Requests"}},"x-codeSamples":[{"lang":"JavaScript","source":"fetch(\"https://maps-api.meteoblue.com/v1/time/hourly_history/NEMSGLOBAL?start=2025-01-01&apikey=YOUR_APIKEY\")\n.then(res => res.json())\n.then(console.log);"},{"lang":"Python","source":"import requests\n\nurl = f\"https://maps-api.meteoblue.com/v1/time/hourly_history/NEMSGLOBAL?start=2025-01-01&apikey=YOUR_APIKEY\"\nresponse = requests.get(url)\nprint(response.json())"},{"lang":"Shell","source":"curl \"https://maps-api.meteoblue.com/v1/time/hourly_history/NEMSGLOBAL?start=2025-01-01&apikey=YOUR_APIKEY\""},{"lang":"Java","source":"import java.net.*;\nimport java.io.*;\n\npublic class Main {\n    public static void main(String[] args) throws Exception {\n        String url = \"https://maps-api.meteoblue.com/v1/time/hourly_history/NEMSGLOBAL?start=2025-01-01&apikey=YOUR_APIKEY\";\n        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();\n        conn.setRequestMethod(\"GET\");\n\n        try (BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()))) {\n            String line;\n            while ((line = in.readLine()) != null) {\n                System.out.println(line);\n            }\n        }\n    }\n}"}]}},"/v1/time/daily_history/{domain}":{"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","enum":["NEMS4","NEMS12","NEMSGLOBAL","GFS05","GFS025","GFS012","MFEU","MFGLOBAL","UMGLOBAL","ICON","ICONEU"]},"description":"Domain (Weather-Model) from which to get the data."},{"name":"start","in":"query","required":true,"schema":{"type":"string","format":"date-time","examples":["2025-01-01T00:00:00Z","2025-01-01"],"pattern":"(?:19|20|21)\\d\\d-?\\d\\d-?\\d\\d(T\\d\\d(:\\d\\d(:\\d\\d)?)?)?Z?"},"description":"Start of timerange of interest."},{"name":"lang","in":"query","schema":{"type":"string","enum":["ar","bg","cs","de","da","el","en","es","fr","hu","it","ja","ka","ko","nl","pl","pt","ro","ru","sk","sl","sr","sv","tr","zh","th","uk","hr","ca","fi","id","no","vi"],"default":"en","x-enumDescriptions":{"ar":"Arabic","bg":"Bulgarian","cs":"Czech","de":"German","da":"Danish","el":"Greek","en":"English","es":"Spanish","fr":"French","hu":"Hungarian","it":"Italian","ja":"Japanese","ka":"Georgian","ko":"Korean","nl":"Dutch","pl":"Polish","pt":"Portuguese","ro":"Romanian","ru":"Russian","sk":"Slovak","sl":"Slovene","sr":"Serbian","sv":"Swedish","tr":"Turkish","zh":"Chinese (Simplified)","th":"Thai","uk":"Ukranian","hr":"Croatian","ca":"Catalan","fi":"Finnish","id":"Indonesian","no":"Norwegian","vi":"Vietnamese"}},"description":"Language to use for localisation purposes."}],"get":{"tags":["Historic Timesteps"],"summary":"Daily Timestamps (Historic)","description":"This endpoint returns the available daily timestamps for historical data of a specified domain.\nThe response provides a list of valid daily time steps that can be used when requesting tile or map data. These timestamps represent the available daily temporal resolution of the underlying dataset and help ensure that subsequent requests use supported values.\nThe endpoint is typically used to retrieve valid historical daily time values before requesting tiles or maps, for example when building day-based visualisations of past weather conditions.","responses":{"200":{"description":"OK","headers":{"MB-Credits-Accounted":{"$ref":"#/components/headers/accounting-header"}},"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","const":"categories"},"categories":{"type":"array","description":"List of categories","examples":[[{"name":"Wed","value":"2025-01-01TZ"},{"name":"Thu","value":"2025-01-02TZ"},{"name":"Fri","value":"2025-01-03TZ"}]],"items":{"type":"object","properties":{"name":{"type":"string","description":"Name of the category, useful for displaying in interfaces.","examples":["Wed"]},"value":{"type":"string","description":"Value of the category, used to make queries for actual data.","examples":["2025-01-01TZ"]}},"required":["name","value"]},"uniqueItems":true},"lastUpdate":{"type":"string","description":"The timestamp of the last update. This can be used for cache invalidation.","examples":["2026-03-19T05:57:17"]},"expires":{"type":"string","description":"At this point in time the map should be reloaded.","examples":["2026-03-19T10:31:54"]}},"required":["type","categories","lastUpdate","expires"]}}}},"400":{"$ref":"#/components/responses/error-response","description":"Bad Request"},"403":{"$ref":"#/components/responses/error-response","description":"Forbidden"},"429":{"$ref":"#/components/responses/error-response","description":"Too Many Requests"}},"x-codeSamples":[{"lang":"JavaScript","source":"fetch(\"https://maps-api.meteoblue.com/v1/time/daily_history/NEMSGLOBAL?start=2025-01-01&apikey=YOUR_APIKEY\")\n.then(res => res.json())\n.then(console.log);"},{"lang":"Python","source":"import requests\n\nurl = f\"https://maps-api.meteoblue.com/v1/time/daily_history/NEMSGLOBAL?start=2025-01-01&apikey=YOUR_APIKEY\"\nresponse = requests.get(url)\nprint(response.json())"},{"lang":"Shell","source":"curl \"https://maps-api.meteoblue.com/v1/time/daily_history/NEMSGLOBAL?start=2025-01-01&apikey=YOUR_APIKEY\""},{"lang":"Java","source":"import java.net.*;\nimport java.io.*;\n\npublic class Main {\n    public static void main(String[] args) throws Exception {\n        String url = \"https://maps-api.meteoblue.com/v1/time/daily_history/NEMSGLOBAL?start=2025-01-01&apikey=YOUR_APIKEY\";\n        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();\n        conn.setRequestMethod(\"GET\");\n\n        try (BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()))) {\n            String line;\n            while ((line = in.readLine()) != null) {\n                System.out.println(line);\n            }\n        }\n    }\n}"}]}},"/v1/time/monthly_history/{domain}":{"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","enum":["NEMS4","NEMS12","NEMSGLOBAL","GFS05","GFS025","GFS012","MFEU","MFGLOBAL","UMGLOBAL","ICON","ICONEU"]},"description":"Domain (Weather-Model) from which to get the data."},{"name":"start","in":"query","required":true,"schema":{"type":"string","format":"date-time","examples":["2025-01-01T00:00:00Z","2025-01-01"],"pattern":"(?:19|20|21)\\d\\d-?\\d\\d-?\\d\\d(T\\d\\d(:\\d\\d(:\\d\\d)?)?)?Z?"},"description":"Start of timerange of interest."}],"get":{"tags":["Historic Timesteps"],"summary":"Monthly Timestamps (Historic)","description":"This endpoint returns the available monthly timestamps for historical data of a specified domain.\nThe response provides a list of valid monthly time steps that can be used when requesting tile or map data. These timestamps represent the available monthly temporal resolution of the underlying dataset and help ensure that subsequent requests use supported values.\nThe endpoint is typically used to retrieve valid historical monthly time values before requesting tiles or maps, for example when building long-term visualisations of past conditions.","responses":{"200":{"description":"OK","headers":{"MB-Credits-Accounted":{"$ref":"#/components/headers/accounting-header"}},"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","const":"categories"},"categories":{"type":"array","description":"List of categories","examples":[[{"name":"2025-01","value":"2025-01-01"},{"name":"2025-02","value":"2025-02-01"},{"name":"2025-03","value":"2025-03-01"}]],"items":{"type":"object","properties":{"name":{"type":"string","description":"Name of the category, useful for displaying in interfaces.","examples":["2025-01"]},"value":{"type":"string","description":"Value of the category, used to make queries for actual data.","examples":["2025-01-01"]}},"required":["name","value"]},"uniqueItems":true},"lastUpdate":{"type":"string","description":"The timestamp of the last update. This can be used for cache invalidation.","examples":["2026-03-15T07:10:27"]},"expires":{"type":"string","description":"At this point in time the map should be reloaded.","examples":["2026-03-19T10:58:35"]}},"required":["type","categories","lastUpdate","expires"]}}}},"400":{"$ref":"#/components/responses/error-response","description":"Bad Request"},"403":{"$ref":"#/components/responses/error-response","description":"Forbidden"},"429":{"$ref":"#/components/responses/error-response","description":"Too Many Requests"}},"x-codeSamples":[{"lang":"JavaScript","source":"fetch(\"https://maps-api.meteoblue.com/v1/time/monthly_history/SA-ENSEMBLE?start=2025-01-01&apikey=YOUR_APIKEY\")\n.then(res => res.json())\n.then(console.log);"},{"lang":"Python","source":"import requests\n\nurl = f\"https://maps-api.meteoblue.com/v1/time/monthly_history/SA-ENSEMBLE?start=2025-01-01&apikey=YOUR_APIKEY\"\nresponse = requests.get(url)\nprint(response.json())"},{"lang":"Shell","source":"curl \"https://maps-api.meteoblue.com/v1/time/monthly_history/SA-ENSEMBLE?start=2025-01-01&apikey=YOUR_APIKEY\""},{"lang":"Java","source":"import java.net.*;\nimport java.io.*;\n\npublic class Main {\n    public static void main(String[] args) throws Exception {\n        String url = \"https://maps-api.meteoblue.com/v1/time/monthly_history/SA-ENSEMBLE?start=2025-01-01&apikey=YOUR_APIKEY\";\n        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();\n        conn.setRequestMethod(\"GET\");\n\n        try (BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()))) {\n            String line;\n            while ((line = in.readLine()) != null) {\n                System.out.println(line);\n            }\n        }\n    }\n}"}]}},"/v1/time/nexthours_history/{domain}":{"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","enum":["NEMS4","NEMS12","NEMSGLOBAL","GFS05","GFS025","GFS012","MFEU","MFGLOBAL","UMGLOBAL","ICON","ICONEU"]},"description":"Domain (Weather-Model) from which to get the data."},{"name":"start","in":"query","required":true,"schema":{"type":"string","format":"date-time","examples":["2025-01-01T00:00:00Z","2025-01-01"],"pattern":"(?:19|20|21)\\d\\d-?\\d\\d-?\\d\\d(T\\d\\d(:\\d\\d(:\\d\\d)?)?)?Z?"},"description":"Start of timerange of interest."},{"name":"lang","in":"query","schema":{"type":"string","enum":["ar","bg","cs","de","da","el","en","es","fr","hu","it","ja","ka","ko","nl","pl","pt","ro","ru","sk","sl","sr","sv","tr","zh","th","uk","hr","ca","fi","id","no","vi"],"default":"en","x-enumDescriptions":{"ar":"Arabic","bg":"Bulgarian","cs":"Czech","de":"German","da":"Danish","el":"Greek","en":"English","es":"Spanish","fr":"French","hu":"Hungarian","it":"Italian","ja":"Japanese","ka":"Georgian","ko":"Korean","nl":"Dutch","pl":"Polish","pt":"Portuguese","ro":"Romanian","ru":"Russian","sk":"Slovak","sl":"Slovene","sr":"Serbian","sv":"Swedish","tr":"Turkish","zh":"Chinese (Simplified)","th":"Thai","uk":"Ukranian","hr":"Croatian","ca":"Catalan","fi":"Finnish","id":"Indonesian","no":"Norwegian","vi":"Vietnamese"}},"description":"Language to use for localisation purposes."}],"get":{"tags":["Historic Timesteps"],"summary":"Next Hours (Historic)","description":"This endpoint returns the available timestamps for historical next-hours accumulation data of a specified domain.\nThe response provides a list of valid time steps that can be used when requesting tile or map data. These timestamps represent short accumulation periods (e.g. `Next 6h`, `Next 12h`, ...) anchored to the given `start` date and help ensure that subsequent requests use supported values.\nThe endpoint is typically used to retrieve valid historical time values before requesting tiles or maps, for example when visualising past accumulated precipitation.","responses":{"200":{"description":"OK","headers":{"MB-Credits-Accounted":{"$ref":"#/components/headers/accounting-header"}},"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","const":"categories"},"categories":{"type":"array","description":"List of categories","examples":[[{"name":"Next 6h","value":"2025-01-01T00:00%2F2025-01-01T06:00"},{"name":"Next 12h","value":"2025-01-01T00:00%2F2025-01-01T12:00"},{"name":"Next 18h","value":"2025-01-01T00:00%2F2025-01-01T18:00"}]],"items":{"type":"object","properties":{"name":{"type":"string","description":"Name of the category, useful for displaying in interfaces.","examples":["Next 6h"]},"value":{"type":"string","description":"Value of the category, used to make queries for actual data.","examples":["2025-01-01T00:00%2F2025-01-01T06:00"]}},"required":["name","value"]},"uniqueItems":true},"lastUpdate":{"type":"string","description":"The timestamp of the last update. This can be used for cache invalidation.","examples":["2026-03-15T07:10:27"]},"expires":{"type":"string","description":"At this point in time the map should be reloaded.","examples":["2026-03-19T10:58:35"]}},"required":["type","categories","lastUpdate","expires"]}}}},"400":{"$ref":"#/components/responses/error-response","description":"Bad Request"},"403":{"$ref":"#/components/responses/error-response","description":"Forbidden"},"429":{"$ref":"#/components/responses/error-response","description":"Too Many Requests"}},"x-codeSamples":[{"lang":"JavaScript","source":"fetch(\"https://maps-api.meteoblue.com/v1/time/nexthours_history/NEMSGLOBAL?start=2025-01-01&apikey=YOUR_APIKEY\")\n.then(res => res.json())\n.then(console.log);"},{"lang":"Python","source":"import requests\n\nurl = f\"https://maps-api.meteoblue.com/v1/time/nexthours_history/NEMSGLOBAL?start=2025-01-01&apikey=YOUR_APIKEY\"\nresponse = requests.get(url)\nprint(response.json())"},{"lang":"Shell","source":"curl \"https://maps-api.meteoblue.com/v1/time/nexthours_history/NEMSGLOBAL?start=2025-01-01&apikey=YOUR_APIKEY\""},{"lang":"Java","source":"import java.net.*;\nimport java.io.*;\n\npublic class Main {\n    public static void main(String[] args) throws Exception {\n        String url = \"https://maps-api.meteoblue.com/v1/time/nexthours_history/NEMSGLOBAL?start=2025-01-01&apikey=YOUR_APIKEY\";\n        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();\n        conn.setRequestMethod(\"GET\");\n\n        try (BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()))) {\n            String line;\n            while ((line = in.readLine()) != null) {\n                System.out.println(line);\n            }\n        }\n    }\n}"}]}},"/v1/time/history/{tileset}":{"parameters":[{"name":"tileset","in":"path","required":true,"schema":{"type":"string","enum":["satellite_global","precipitation_global"]},"description":"Tileset for which to get the data"},{"name":"start","in":"query","required":true,"schema":{"type":"string","format":"date-time","examples":["2025-01-01T00:00:00Z","2025-01-01"],"pattern":"(?:19|20|21)\\d\\d-?\\d\\d-?\\d\\d(T\\d\\d(:\\d\\d(:\\d\\d)?)?)?Z?"},"description":"Start of timerange of interest."},{"name":"end","in":"query","required":true,"schema":{"type":"string","format":"date-time","examples":["2025-01-02T00:00:00Z","2025-01-02"],"pattern":"(?:19|20|21)\\d\\d-?\\d\\d-?\\d\\d(T\\d\\d(:\\d\\d(:\\d\\d)?)?)?Z?"},"description":"End of timerange of interest."}],"get":{"tags":["Radar & Satellite Timesteps"],"summary":"History","description":"This endpoint returns the available timestamps for historical data for a specified tileset.\nThe response provides a list of valid historical time steps that can be used when requesting tile or map data. These timestamps represent the available past data coverage of the selected tileset and help ensure that subsequent requests use supported values.\nThe endpoint is typically used to retrieve valid historical time values before requesting tiles or maps, for example when visualising past weather conditions, building historical animations, or analysing earlier time periods.\n\nThe time range between `start` and `end` may not exceed 30 days, otherwise a `400 Bad Request` is returned. To cover a longer period, split it into multiple requests of up to 30 days each.\nIn addition, `start` cannot be before `2019-12-19T00:00Z` and `end` cannot be in the future.","responses":{"200":{"description":"OK","headers":{"MB-Credits-Accounted":{"$ref":"#/components/headers/accounting-header"}},"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","const":"timesteps"},"format":{"type":"string","const":"H:i"},"timesteps":{"type":"array","items":{"type":"object","properties":{"timestep":{"type":"string"},"value":{"type":"string"}},"required":["timestep","value"]}},"lastUpdate":{"type":["string","null"],"description":"The timestamp of the last update. This can be used for cache invalidation.","examples":[null]},"expires":{"type":["string","null"],"description":"At this point in time the map should be reloaded.","examples":[null]}},"required":["type","format","timesteps","lastUpdate","expires"]}}}},"400":{"$ref":"#/components/responses/error-response","description":"Bad Request"},"403":{"$ref":"#/components/responses/error-response","description":"Forbidden"},"429":{"$ref":"#/components/responses/error-response","description":"Too Many Requests"}},"x-codeSamples":[{"lang":"JavaScript","source":"fetch(\"https://maps-api.meteoblue.com/v1/time/history/satellite_global?start=2026-01-01T00:00:00Z&end=2026-01-02T00:00:00Z&apikey=YOUR_APIKEY\")\n.then(res => res.json())\n.then(console.log);"},{"lang":"Python","source":"import requests\n\nurl = f\"https://maps-api.meteoblue.com/v1/time/history/satellite_global?start=2026-01-01T00:00:00Z&end=2026-01-02T00:00:00Z&apikey=YOUR_APIKEY\"\nresponse = requests.get(url)\nprint(response.json())"},{"lang":"Shell","source":"curl \"https://maps-api.meteoblue.com/v1/time/history/satellite_global?start=2026-01-01T00:00:00Z&end=2026-01-02T00:00:00Z&apikey=YOUR_APIKEY\""},{"lang":"Java","source":"import java.net.*;\nimport java.io.*;\n\npublic class Main {\n    public static void main(String[] args) throws Exception {\n        String url = \"https://maps-api.meteoblue.com/v1/time/history/satellite_global?start=2026-01-01T00:00:00Z&end=2026-01-02T00:00:00Z&apikey=YOUR_APIKEY\";\n        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();\n        conn.setRequestMethod(\"GET\");\n\n        try (BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()))) {\n            String line;\n            while ((line = in.readLine()) != null) {\n                System.out.println(line);\n            }\n        }\n    }\n}"}]}}},"x-tagGroups":[{"name":"Time-API","tags":["Recent Timesteps","Historic Timesteps","Radar & Satellite Timesteps"]}],"components":{"responses":{"error-response":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean","const":true,"description":"Flag indicating that an error has occurred."},"error_message":{"type":"string","description":"Message describing the error."}},"required":["error","error_message"]},"examples":{"Error Message Example":{"summary":"Example Error","description":"Example of a possible error message","value":{"error":true,"error_message":"Message describing the error."}}}}}}},"headers":{"accounting-header":{"schema":{"type":"integer","examples":[0],"minimum":0},"description":"The total number of credits which were accounted from the user of the apikey for the made request."}},"securitySchemes":{"apikey":{"description":"A meteoblue API access key.","type":"apiKey","name":"apikey","in":"query"}}}}