Introduction

The Democrance API is a JSON based RESTful API, designed to permit the creation of differing front-ends for selling and administering insurance policies for brokers and end customers.

The API consists of various end-points for registering new policies, registering payments (for supported payment gateways), and issuing policies based on other entitlement criteria, such as meeting a certain usage level on a mobile subscription, or paying for insurance via points, or direct billing through the partner/agent.

Versioning

This document describes the latest version of our API that has been released publically. Versioning is built into the URL’s of the various calls, where the version number is built into the URL. For example, our urls will begin with /api/v3/ to indicate the version of the call you are working against.

Time

Times are always reported in UTC time, unless otherwise indicated explicitly. Date/time formats are always passed in ISO 8601 format, so dates will be in YYYY-MM-DD format and times in YYYY-MM-DDTHH:MM:SSZ format.

Cross origin resource sharing

The API supports Cross Origin Resource Sharing (CORS) for AJAX requests from any origin. You can read the CORS W3C Recommendation <http://www.w3.org/TR/cors/>, or this intro <http://code.google.com/p/html5security/wiki/CrossOriginRequestSecurity> from the HTML 5 Security Guide.

If you are developing a custom browser based user interface, you will need to register the origin domain with us. Please email the support address below to get your domain added to the accepted CORS hosts.

Support

For support queries please email support@democrance.com.