Skip to content
Switch branches/tags


Failed to load latest commit information.


Socotra Library

Socotra's insurance platform is designed to be extended through configuration and its open APIs. While the product handles the "core", there are often many enhancements or extensions that may match your situation. To ease the learning curve, Socotra provides integrations, code samples, example product configuration, and helpful test utilities that may aid in your processes. Feel free to use as-is or modify to best suit your needs.

Visit or contact us at

Table of Contents

default_config: The default configuration files serve as realistic examples of how a variety of features are used in practice. Default products include auto and term life.

socotratools: This 2.7 Python package can be installed using pip. It includes a client wrapper for REST calls and utilities to manipulate dates in a specific timezone.

create_policy: Sometimes it's helpful to create a policy programatically. This simple script uses json files to generate motor policies using the default configuration.

document_tools: These tools show how to render a template in Socotra without using the front-end - helpful for document develoment. Scripts for adding and removing documents are also added for convenience.

premium_test: These tools allow you to quickly iterate to develop your ratings engine using an existing policy/peril or by creating a peril from JSON files.

general_ledger: A common operation is to take the Soctora standard reports and import them into general ledger software systems for financial reporting. This example uses PeopleSoft's import format but journal entries should be similar in other systems.

data_dictionary: When developing against the API, it's helpful to have a reference of all the product fields configured in an instance. This script generates a CSV of all fields and associated data types.

stripe: This example uses Stripe's payment processor to pay a policyholder's outstanding invoices.

cognito: These tools show how to use an external directory service to add permissions to Socotra for various API function calls. The example provided uses the AWS Cognito service.

product_examples: Socotra can be configured for any line of business. In this directory, you can find sample product configurations for various lines of business to adapt to your needs.


GNU Lesser General Public License


No description, website, or topics provided.



No releases published


No packages published