{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"ee8152e3-e261-4487-8010-48466644497f","name":"Stau1 API (Beta)","description":"The Stau1 API consists of a set of REST API endpoints providing access to historic, incident-based traffic data in Germany as well as related road and location data. Most data and data structures are based on or derived from the [TMC](https://de.wikipedia.org/wiki/Traffic_Message_Channel) standard.\n\nAny usage of API endpoints described in this documentation as well as the documentation itself is subject to TechSeed GmbH's [General Terms](https://stau1.de/about/agb.php), its [API Terms & Conditions](https://stau1.de/about/agb-stauarchiv-api.php) and [Privacy Policy](https://stau1.de/about/datenschutz.php).    \n \n\n\n### Traffic Archive API\nStau1's Traffic Data Archive Search API allows retrieving historic traffic information reported for highways (Autobahnen) and other local roads types (Bundesstraßen, Landstraßen) in Germany.   \nThe data pool consists of incident-based traffic events as reported and electronically transmitted to our database by local state government- and police agencies.   \n>IMPORTANT DISCLAIMER: Although comprehensive and covering the majority of traffic events, Stau1 and its data sources are not liable for completeness and accuracy of traffic data collected.\n\nSee [Traffic Archive API Reference](#a728b657-ebdc-4b11-86d4-058c19016da5)  \n\n    \n\n\n### Road Data API\nWhenever possible, the location of a traffic incident is allocated to a specific road and road section. The Road Data API provides respective Road Location Data for a given road or region.  \n\nSee [Road Data API Reference](#d4907fa4-8741-45ff-ae51-9fa53ee041bf)  \n \n\n### Event Code API\nThis API endpoint allows querying the traffic incident event code database and is helpful for decoding event codes provided by the Traffic Archive API.   \n\nSee [Event Code API Reference](#f8308e55-31dd-4db1-8ba1-c326d0dd636e)  \n   \n\n### Region Codes\nTraffic and Road data can be filtered by State (Bundesland). Different German states are represented by Region IDs.   \nSee [List of Region IDs](#4dc3f6dc-9443-4153-86ab-76ee13a953ed)  \n   \n\n# Authentication\nSimple authentication is provided via a dedicated API key. Since API usage charges are dependent on the number of requests performed during a certain time period and are attributed to your API key, it is important that you don't expose your API key to the public in order to prevent misue of your account which may result in unexpected charges.\n>The API key used in this documentation is for testing purposes only and limited to querying traffic incidents of July 1, 2019.\n\n# Error Codes\nIn case an API request results in an error, the error is represented by an error object in the JSON response object.\n\n| Error | Message | Description |\n|--------|-----------------------------------------|-----------------------------------------------------------------------------------------------------------|\n| E0000 | Network Error | No Internet connection or server temporarily unavailable.  |\n| E0001 | Unknown Error | An unspecified error occurred. Contact support along with the API request that caused the error to occur. |\n| E0002 | Failed loading data | An internal read operation failed on the Stau1 API server. |\n| E0003 | Failed saving data | An internal write operation failed on the Stau1 API server. |\n| E0004 | Invalid input parameter | One of the input parameters provided for the API request is invalid. |\n| E0006 | Authorization failed | The API key is invalid or not authorized to perform the request. |\n| E0100  | Invalid or missing input parameter | An unspecified but mandatory parameter is missing or invalid. |\n| E0101 | Missing start or end parameter | A Traffic Archive API request is either missing a *start* or *end* parameter. |\n| E0102 | Region and near cannot be combined | The *regions* and *near* parameter cannot be combined when querying  the Traffic Archive API. |\n| E0104 | Age out of range | The value used for the *age* parameter on a Traffic API request is invalid. |\n| E0105 | Age cannot be combined with start/ end  | The *age* parameter cannot be used during Traffic Archive API request. |\n| E0106 | Invalid near parameter | The value used for the *near* parameter on a Traffic Archive API call is invalid. |\n| E0107 | Invalid time range | The time range specified by *start* and *end* parameters must not exceed 24 hours. |\n| E0108 | Invalid region | The value used for the *regions* parameter on a Traffic API request is invalid. |\n| E0130 | Error obtaining road info | The road info requested by the Road Data API could not be provided. |\n\n  \n    \n\n# API Reference","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"9517860","team":637212,"collectionId":"ee8152e3-e261-4487-8010-48466644497f","publishedId":"SW7f16WE","public":true,"publicUrl":"https://docs.stau1.de","privateUrl":"https://go.postman.co/documentation/9517860-ee8152e3-e261-4487-8010-48466644497f","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"B94A48"},"documentationLayout":"classic-double-column","version":"8.11.8","publishDate":"2020-01-04T18:34:42.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{},"logos":{}},"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/611aca05edde7b987a516668f4e0f98bcea2fd79d43e37f7a1499eb79022ec12","favicon":"https://res.cloudinary.com/postman/image/upload/v1578159884/team/ipldsen76vd5hdpieubs.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://docs.stau1.de/view/metadata/SW7f16WE"}