Skip to main content

Overview

The Product Catalog is the discovery surface of Insurance-as-a-Service: it answers "what can my integration sell?" and "how do I build a valid selection to quote?". It consists of two read-only endpoints, scoped to the products enabled for your integration.

Concepts

ConceptDescription
Product (product)An insurance product from a partner insurer (e.g. a credit life product, a group life product). It is the unit of sale: each product sold in an order produces one policy. Addressed by product_key.
Coverage (service)A coverage or benefit that composes the product (e.g. death, accidental disability, funeral assistance). It can be mandatory (mandatory) or optional. Addressed by service_key.
Option spaceThe configurable limits of each coverage: maximum insured amount (maximum_insured_amount) and the typed envelopes of accepted deductibles (deductible_options) and waiting periods (waiting_period_options). A selection outside the option space is rejected at quote time.
DependenciesStructural rules between coverages of the same product: include (prerequisite coverages) and exclude (mutually exclusive coverages).
Commission band (commission_bounds)The {minimum_rate, maximum_rate, default_rate} band of your commission per sale of that product. The commission sent in the quote and the order (commission_data) is validated against this band; when omitted, default_rate applies.
Default configuration (default_configuration)Default coverage values configured for your integration. When the selection omits the services list, the quote automatically fills in every configured default coverage.

Product classification

Every product carries a regulatory and commercial classification:

FieldDescription
product_categoryinsurance, capitalization or benefit. A product may combine coverages of different categories (e.g. insurance + assistance).
insurance_classThe product's SUSEP line of business (e.g. credit_life). Absent for non-insurance products. In the quote and the order, the line of business is returned as the object { name, class_number, group_number }.
regulator_registrationThe product's SUSEP registration (Código SUSEP).

Visibility and confidentiality

  • Only active products enabled for your integration are visible; a product belonging to another partner (or a nonexistent one) returns 404.
  • The commission band returned is always yours — never another partner's.
  • The insurer's internal pricing and eligibility rules are not exposed: you receive the structural limits (option space and dependencies) and the evaluation result at quote time.

Endpoints

EndpointDescription
GET /v1/product_catalog/productsLists the products your integration can sell.
GET /v1/product_catalog/products/{product_key}Details one product: coverages, option spaces, dependencies, your defaults and your commission band.