{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"aa5f2747-c1d4-4a10-99e7-28fdf5205c9f","name":"HDI EMBEDDED API","description":"Welcome to the HDI Embedded developer API. You'll find comprehensive guides and documentation to help you start working with our APIs as quickly as possible, as well as support if you get stuck. Let's jump right in!\n\n# About Us\n\nWe effortlessly design and deliver **modular insurance solutions** tailored to the needs of your business and your customers at incredibly fast implementation speed. Thanks to our **agile approach** and **state-of-the-art technology**, you can combine **traditional, fully digital or parametric insurance solutions** to be embedded into your product or service and presented to your customer at the optimum stage of their customer journey. Plus our digital end-to-end insurance platform that we offer is fully **GDPR-compliant** and comprises a high level of **cyber security**.\n\nWe offer insurance solutions with a fast digital claims handling for **financial services, travel, retail, telco, events, and more. Whatever your line of business, we've got you – and especially your customer – covered**. After all, a satisfied customer is a loyal customer.\n\n# Why Choose HDI Embedded API Platform?\n\nHDI Embedded offers the easiest possible integration with our partners. With our API and documentation, you can quickly connect to our system and offer new products to your customers.\n\n## Cloud-Based Platform\n\nOur platform is cloud-based, meaning you can access it from anywhere in the world. No matter where you are, our API is always available.\n\n## Multi-Format API (Customizable to Partner Needs)\n\nWe offer the flexibility to provide API in various formats, such as REST and RPC, which can be customized to suit the specific requirements of our partners. This allows you to tailor the integration precisely to your own needs and preferences.\n\n## Security First\n\nAt HDI Embedded, we prioritize the security of your data. Our authentication and authorization are based on the OAUTH2, ensuring that your data is always protected.\n\n## International Adaptation\n\nOur API supports dates in international formats, making it easier to work with customers from different regions of the world. You don't have to worry about date conversions - we'll take care of that for you.\n\n## Multilingual and Multicurrency\n\nWe are flexible when it comes to languages and currencies. Our API supports multiple languages and currencies, allowing you to tailor your offerings to various markets and customers.\n\n# About our API\n\n## Glossary\n\n**Access Token** - the application receives an access token after a user successfully authenticates and authorizes access . An access token is generated from the Identity Server and must be used when consuming any of our APIs. The access token is passed as a header authorization parameter for the relevant service.\n\n**API** - an Application Programming Interface is a software intermediary that allows two applications to talk to each other.\n\n**DELETE** - a DELETE method is used to delete a specified resource.\n\n**GET** - a GET method is used to retrieve data for a specified resource or a list of resources.\n\n**PUT** - a PUT method is used to update a single resource\n\n**POST** - a POST method is used to create a single resource\n\n**Request** - a request allows you to either retrieve or send data from/to API\n\n**Response** - a response is returned to confirm whether a received request was successfully executed or not\n\n## Error Codes\n\nHDI Embedded uses conventional HTTP response codes to indicate the success or failure of an API request. Error codes ranging from 200 to 299 indicate a successful operation. Error codes ranging from 400 to 499 represent various error codes. Errors that can be resolved programmatically will result in an error code that briefly explains the type of error or reason for the error. 5xx codes indicate an error within the HDI Embedded servers, which will be minimized on our end. In the unlikely event of a 5xx error, our engineering team will automatically receive a report and will fix the issue as fast as possible.\n\n| Status | Description |\n| --- | --- |\n| 200 – OK | Everything worked as expected. |\n| 201 – Created | The request has been fulfilled and has resulted in one or more new resources being created. |\n| 400 - Bad Request | The request was not accepted, often due to the wrong format of the request. |\n| 401 – Unauthorized | No valid API key was provided. |\n| 402 - Request Failed | The parameters were valid, but the request failed. |\n| 404 - Not Found | The requested resource doesn't exist. |\n| 409 – Conflict | The request conflicts with another request, perhaps due to the usage of the same idempotency key. |\n| 422 - Unprocessable Entity | Used mostly for validation or logical errors. |\n| 429 - Too Many Requests | Too many requests hit the API too quickly. We recommend an exponential back-off of your requests. |\n| 500, 502, 503, 504 - Server Errors | Something went wrong on our platform end. |","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"10077121","team":1215554,"collectionId":"aa5f2747-c1d4-4a10-99e7-28fdf5205c9f","publishedId":"2s9Y5SV5R7","public":true,"publicUrl":"https://apidoc.hdi-embedded.com","privateUrl":"https://go.postman.co/documentation/10077121-aa5f2747-c1d4-4a10-99e7-28fdf5205c9f","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":"https://content.pstmn.io/b49293e3-a8f8-43fb-a01f-f2a679fc54f5/SERJIEVtYmVkZGVkIExvZ29fdHJhbnNwYXJlbnQucG5n","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":"https://content.pstmn.io/b49293e3-a8f8-43fb-a01f-f2a679fc54f5/SERJIEVtYmVkZGVkIExvZ29fdHJhbnNwYXJlbnQucG5n","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2023-11-06T10:54:17.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":"https://content.pstmn.io/b49293e3-a8f8-43fb-a01f-f2a679fc54f5/SERJIEVtYmVkZGVkIExvZ29fdHJhbnNwYXJlbnQucG5n","logoDark":"https://content.pstmn.io/b49293e3-a8f8-43fb-a01f-f2a679fc54f5/SERJIEVtYmVkZGVkIExvZ29fdHJhbnNwYXJlbnQucG5n"}},"statusCode":200},"environments":[{"name":"Partner public einvironment","id":"d9f694c2-0615-41a4-b5cf-28bb9e8e1d77","owner":"10077121","values":[],"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/5c0f63812cb3b8d3d9052c141b7bd56fe378d474dda153d2c6000f9a96f3d89c","favicon":"https://hdi-embedded.com/favicon.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"},{"label":"Partner public einvironment","value":"10077121-d9f694c2-0615-41a4-b5cf-28bb9e8e1d77"}],"canonicalUrl":"https://apidoc.hdi-embedded.com/view/metadata/2s9Y5SV5R7"}