Skip to main content

Get Proposal Form​

Retrieves Proposal Form based on unique productId,manufacturerId and version

Query Parameters
    productId Product id required
    manufacturerId Manufacturerid required
    version Version required
Responses

Successful Response

Schema
    errors object

    This array contains error messages in case of an error

    reqId string required

    Request Id for the quote assigned by 1SB

    data object required

    Section to carry responses

    productId string

    Product Id

    fieldGroups object

    This section will carry multiple sub field groups and fields also carry attributes which give additional information for each field, such as

    • id : Unique internal identifier for the field configuration. Used for ordering, mapping, or reference within the proposal/quote master.
    • name : Technical name of the field used as a key in request and response payloads. - label : Display label of the field shown on the user interface.
    • type : Data type of the field value (e.g., text, number, date).
    • input : UI input control type (e.g., textbox, dropdown). Empty indicates default control.
    • min : Minimum allowed length of the input value.
    • max : Maximum allowed length of the input value.
    • order : Sequence number that determines the position of the field on the UI.
    • value : List of predefined or selectable values applicable for dropdown or option-based fields.
    • entity : Reference to an external entity or master data source, if applicable . - default : Default value assigned to the field when no user input is provided.
    • defaultExp : Expression used to dynamically derive the default value at runtime.
    • mandatory : Indicates whether the field is mandatory (1 = Mandatory, 0 = Optional).
    • pattern : Regular expression pattern used to validate the input value.
    • validation : Validation rule or validation type applied to the field.
    • validationExp : Expression used to evaluate custom validation logic.
    • visibility : Rule or condition that controls whether the field is visible on the UI.
    • description : Detailed explanation of the field’s purpose.
    • mappingType : Defines how the field maps to insurer or internal system fields.
    • placeholder : Hint text displayed inside the input field before the user enters a value.
    • pythonDefaultExp : Python expression used to calculate the default value dynamically.
    • pythonValidationExp : Python expression used to perform custom validation.
    • pythonVisibilityExp : Python expression used to dynamically control field visibility.
    traceInfo object required

    Section to capture tracking and reference information used to trace the proposal across 1SB and insurer systems. These identifiers help in mapping quotes, proposals, and applications during the proposal lifecycle.This section will carry attributes which give additional information. example: name, description, type, pattern, order, visibility, validation, mandatory, etc

    fields object

    This section will carry attributes which give additional information such as name, description, type, length, order, visibility, validation, and mandatory status for each tracking field.

    manufacturerQuoteID string

    Possible values: <= 50 characters

    Quote identifier generated by the insurance manufacturer. This value is used to uniquely identify the quote at the insurer’s system and is helpful for reconciliation and tracking.

    1SBQuoteRequestID string

    Possible values: non-empty and <= 50 characters

    Unique quote request ID generated by 1SilverBullet. This ID is used internally to track the quote request across multiple downstream systems and APIs.

    manuApplicationNo string

    Possible values: <= 50 characters

    Application number generated by the insurance manufacturer once the proposal is created. This number is used for all subsequent interactions with the insurer.

    1SBproposalRefId string

    Possible values: non-empty and <= 50 characters

    Unique proposal reference ID generated by 1SilverBullet. This ID acts as the primary reference for tracking the proposal status, documents, and integrations within the 1SB platform.

    manufacturerQuoteDate string

    Date on which the Single Quote is generated by 1SilverBullet. This is used for quote tracking and reference.

    transactionId string

    "Unique transaction reference ID generated for each proposal or payment request to track the transaction across systems. https://uathealth.inkasure.com/#/?id=00000000-0000-0000-0000-000000000010

    distributor object required

    This section captures distributor and sales channel details involved in the proposal. These details are used by 1SilverBullet and insurance companies to identify the intermediary, sales channel, and source of the transaction. This section will carry attributes which give additional information such as name, description, type, length, order, visibility,validation, and mandatory status for each tracking field.

    fields object

    This section contains additional attributes for distributor-related fields, which may vary based on the insurer and distributor. Insurer-specific mandatory fields (e.g., Agent ID and Channel Type for ICICI) will be added as required and passed to the respective insurer.

    These attributes include details such as ID, field name, data type, input type, length constraints, default value, pattern, display settings, validation rules, mandatory flag, mapping type, and system-driven expressions for defaulting, validation, and visibility.

    agentCode string required

    This field value will be provided by consumer app as assigned by insurance company or SP code intermediary code assigned by the insurance company. This value is provided by the consumer application and is used to uniquely identify the selling agent or partner.

    channelType string required

    Possible values: [B2B, B2C]

    Identifies the sales channel through which the proposal is sourced. This field is insurer dependent and is used to classify transactions such as B2B, B2C, corporate agents, brokers, or other channels.

    buyersZipCode string

    Possible values: <= 10 characters

    Postal or ZIP code of the buyer’s location. This may be used by insurers for regional classification or compliance checks.

    distributorID string

    Possible values: non-empty and <= 20 characters, [AIBPL, LTFHL]

    Unique distributor identifier assigned by 1SilverBullet. This ID is used to map proposals to the registered distributor.

    sellersZipCode string

    Possible values: <= 20 characters

    Postal/ZIP code of the vehicle seller, used for location identification and record purposes

    spCode string

    Possible values: non-empty and <= 50 characters

    Sales Partner (SP) code identifying the agent, dealer, or distribution partner associated with the transaction.

    proposerDetails object required

    Section to capture proposer information. The proposer is the individual responsible for submitting the proposal and paying the premium. These details are required for underwriting, KYC, regulatory compliance, and communication.Please refer the Master Lookup API for getting Enum value of the perticular tag.

    corporateDetails object

    Section to capture corporate, business, and regulatory details when the policyholder is a Corporate entity (Company/Firm/Organization). The structure and fields within this section are entirely driven by the insurer’s proposal master configuration. Insurers may add, remove, or modify fields as required and define corresponding validations based on their underwriting, compliance, and regulatory requirements. This section will carry attributes that provide additional information for each corporate field, such as unique identifier (id), field name, data type, input type, minimum and maximum length, default values, patterns, visibility rules, validation rules, mandatory indicators, mapping type, and system-driven expressions.

    fields object

    This section will carry attributes which give additional information for each proposer personal field, such as unique identifier (id), field name, data type, input type, min/max length, default values, pattern, visibility rules, validation rules, mandatory indicator, mapping type, and system-driven expressions.

    nameOfCompany string required

    Possible values: non-empty and <= 50 characters

    Legal name of the company as per registration records. Must contain minimum 2 words and be between 1 to 50 characters.

    dateOfEstablishment string required

    Date of establishment cannot be the current or a future date.

    gstNumber string required

    Possible values: >= 15 characters and <= 15 characters

    15-digit Company GST Identification Number (GSTIN) of the policyholder. Must be exactly 15 characters (min- 15, max- 15).

    panNumber string required

    Possible values: >= 10 characters and <= 10 characters

    Permanent Account Number (PAN) of the company. Must be a valid 10-character alphanumeric PAN in the format- 5 uppercase letters, 4 digits, and 1 uppercase letter (e.g., ABCDE1234F).

    personalDetails object

    Section to capture personal, demographic, and regulatory details of the proposer. The structure and fields within this section are entirely driven by the insurer’s proposal master configuration. Insurers may add, remove, or modify fields as required and define corresponding validations based on their underwriting and regulatory requirements. This section will carry attributes that provide additional information for each proposer personal field, such as unique identifier (id), field name, data type, input type, minimum and maximum length, default values, patterns, visibility rules, validation rules, mandatory indicators, mapping type, and system-driven expressions.

    fields object

    This section will carry attributes which give additional information for each proposer personal field, such as unique identifier (id), field name, data type, input type, min/max length, default values, pattern, visibility rules, validation rules, mandatory indicator, mapping type, and system-driven expressions.

    fullName string

    Possible values: >= 3 characters and <= 22 characters

    Full name of proposer as per valid ID proof.

    firstName string required

    Possible values: non-empty and <= 30 characters

    First name of proposer as per valid ID proof.

    middleName string

    Possible values: <= 30 characters

    Middle name of proposer as per ID proof.

    lastName string required

    Possible values: non-empty and <= 30 characters

    Last name of proposer as per valid ID proof.

    maritalStatus string required

    Possible values: [MARRIED, SINGLE]

    Current marital status of the proposer.

    dateOfBirth date

    Date of Birth of Member. Date is formatted string as per ISO 8601 standard. Format - YYYY-MM-DD

    gender string

    Possible values: [MALE, FEMALE, OTHER]

    Gender of the proposer.

    mobileNumber string required

    Possible values: >= 10 characters and <= 16 characters

    Proposer mobile number for OTP and communication.

    policyHolderType string

    Possible values: [Yes, No]

    Is Policyholder an Individual should be "Yes" when you select personal accident cover .

    gstNumber string

    Possible values: >= 15 characters and <= 15 characters

    15-digit GST Identification Number (GSTIN) of the policyholder. Must be exactly 15 characters (min- 15, max- 15).

    autoMobileAssociationMember string

    Possible values: [SOCIETY OF INDIAN AUTOMOBILE MANUFACTURERS, THE AUTOMOTIVE COMPONENT MANUFACTURERS ASSOCIATION OF INDIA, THE FEDERATION OF AUTOMOBILE DEALERS ASSOCIATIONS, THE WESTERN INDIA AUTOMOBILE ASSOCIATION]

    Indicates whether the policyholder is a member of a recognized Automobile Association, which may make them eligible for applicable discounts.

    MembershipId string

    Membership number of the recognized Automobile Association. Mandatory when Automobile Association cover/discount is selected (not applicable for Standalone TP policies).

    autoAssoExpDate string

    Expiry date of the Automobile Association membership. Mandatory when Automobile Association cover/discount is selected (not applicable for Standalone TP policies). The expiry date must not be earlier than the policy start date.

    email string

    Possible values: <= 50 characters

    Email address of proposer.

    occupation string

    Occupation of the policyholder.

    panNumber string required

    Possible values: >= 10 characters and <= 10 characters

    PAN number of proposer in uppercase.

    communicationAddressDetails object

    Section to capture Communication Address details of the Life Assured

    fields object
    addressLine1 string required

    Type your correct address

    addressLine2 string

    Provide if applicable, special character not allowed

    addressLine3 string

    Provide if applicable, special characters not allowed

    landmark string

    Type the Landmark of the area

    zipCode string required

    Zip Code of the area provided above

    city string required

    Type name of city

    state string required

    Select name of state

    country string required

    Select name of country

    sameAddress boolean required

    Is your Permanent address same as Communication address?

    permanentAddressDetails object

    Section to capture Permanent Address details

    fields object
    addressLine1 string required

    Provide if applicable

    addressLine2 string

    Provide if applicable, special character not allowed

    addressLine3 string

    Provide if applicable, special character not allowed

    landmark string

    Provide if applicable

    zipCode string required

    Type correct zip code

    city string required

    Type name of city

    state string required

    Select name of state

    country string required

    Select name of the country

    vehicleDetails object

    Section to capture vehicle-specific, registration, ownership, financing, and usage-related details required for motor insurance underwriting and policy issuance.

    The structure and fields within this section are entirely driven by the insurer’s proposal master configuration. Insurers may add, remove, or modify vehicle-related fields such as engine number, chassis number, registration details, RTO code, ownership sequence, hypothecation details, odometer reading, and driving license information based on their underwriting, regulatory, and product requirements.

    This section carries configurable attributes for each vehicle field, including unique identifier (id), field name, data type, input type, minimum and maximum length, default values, validation rules, patterns, visibility conditions, mandatory indicators, mapping type, and system-driven expressions.

    makeModelVariantDetails object

    Section to capture vehicle-specific details such as make, model, variant, engine number, chassis number, registration number, RTO code, ownership sequence, and vehicle usage information required for motor insurance underwriting.

    The structure and fields within this section are entirely driven by the insurer’s proposal master configuration. Insurers may add, remove, or modify vehicle-related fields as required and define corresponding validations based on their underwriting, regulatory, and product requirements.

    This section carries attributes that provide additional information for each vehicle field, such as unique identifier (id), field name, data type, input type, minimum and maximum length, default values, patterns, visibility rules, validation rules, mandatory indicators, mapping type, and system-driven expressions.

    fields object

    This section will carry attributes which provide additional information for each insurer-specific vehicle detail field (e.g., make, model, variant, engine number, chassis number, registration details), including unique identifier (id), field name, data type, input type, minimum and maximum length, default values, pattern, visibility rules, validation rules, mandatory indicator, mapping type, and system-driven expressions.

    vehicleEngineNumber string required

    Possible values: >= 6 characters and <= 30 characters

    Engine number of the insured vehicle. Must be between 6 and 30 alphanumeric characters and cannot be the same as the chassis number.

    vehicleChassisNumber string required

    Possible values: >= 17 characters and <= 17 characters

    Vehicle chassis number (17 alphanumeric characters). Cannot match the engine number.

    vehicleOwnerSequence string required

    Possible values: [1ST OWNER, 2ND OWNER]

    Indicates whether the vehicle is owned by the 1st owner or 2nd owner, as per registration records.

    rtoCode string required

    Possible values: non-empty and <= 4 characters

    Regional Transport Office (RTO) code of the vehicle registration location. Must be between 1 to 4 characters and is used to determine applicable premium, taxation, and underwriting rules.

    vehicleNumber date required

    Vehicle registration number as per RC records. Mandatory for used/roll-over vehicles (not required for new vehicles). Must follow valid registration format based on RTO type (including BH series rules where applicable).

    isValidDrivingLicenseAvailable string required

    Confirms if the proposer holds a valid driving license.

    doYouHaveCPA string required

    Indicates whether the proposer already holds an active ₹15 lakh Compulsory Personal Accident (CPA) cover under a standalone PA policy or another motor insurance policy.

    financierDetails object

    Section to capture financing or hypothecation details of the insured vehicle. These details include whether the vehicle is under loan/lease/hire purchase and the corresponding financier information. This information is used for policy endorsement, underwriting, and to record hypothecation details on the policy schedule as required by the insurer.

    fields object

    Fields to capture insurer-specific vehicle financing details, including loan/hypothecation status, type of finance (Hire Purchase, Hypothecation, or Lease), and financier name. These details are used to record hypothecation information on the policy schedule and for underwriting purposes.

    vehicleHypothecation string required

    Possible values: [Yes, No]

    Indicates whether the insured vehicle is financed, under loan, lease, or hypothecation. If 'Yes', financier details must be provided..

    financierType string required

    Possible values: >= 1, [HIRE PURCHASE, HYPOTHECATION, LEASE]

    Specifies the type of vehicle financing arrangement, such as Hire Purchase, Hypothecation, or Lease. Applicable when the vehicle is financed.

    financierName string required

    Possible values: non-empty and <= 256 characters, >= 1

    Name of the financial institution or lender providing the vehicle loan. Required when the vehicle is financed.

    odometerDetails object

    Section to capture vehicle odometer-related details, such as current odometer reading and the date of capture. These details are required when usage-based or Pay-As-You-Drive covers are selected. This section will carry attributes that provide additional information for each insurer-specific odometer field, including unique identifier (id), field name, data type, input type, minimum and maximum length, default values, patterns, visibility rules, validation rules, mandatory indicators, mapping type, and system-driven expressions.

    fields object

    Fields to capture insurer-specific odometer information, including current odometer reading and its capture date. These details are required for usage-based or Pay-As-You-Drive motor insurance covers and are used for underwriting and premium calculation.

    odometerReading string required

    Possible values: non-empty and <= 9999999 characters

    Current odometer reading of the vehicle in kilometers. Must be between 1 and 9,999,999. Required when usage-based (Pay-As-You-Drive) cover is selected.

    odoMeterCaptureDate string required

    Date on which the odometer reading was recorded. Required when usage-based (Pay-As-You-Drive) cover is selected.

    previousPolicyDetails object

    Section to capture previous insurance policy details of the insured vehicle. This section is applicable only for Roll-Over cases and is not required for New Business policies. It includes details such as previous insurer name, policy type, policy number, coverage type, and policy start and expiry dates (including OD and TP details where applicable). The structure and fields within this section are entirely driven by the insurer’s proposal master configuration. Insurers may add, remove, or modify previous policy-related fields based on their underwriting, regulatory, and continuity requirements. This section carries configurable attributes for each previous policy field, including unique identifier (id), field name, data type, input type, minimum and maximum length, default values, validation rules, patterns, visibility conditions, mandatory indicators, mapping type, and system-driven expressions.

    ownDamagePolicyDetails object

    Section to capture previous Own Damage (OD) policy details of the insured vehicle, applicable in Roll-Over cases where OD and TP policies may be issued separately (e.g., bundled or standalone structures).

    This includes details such as previous OD insurer name, OD policy number, OD policy start date, and OD policy expiry date.

    The structure and fields within this section are entirely driven by the insurer’s proposal master configuration. Insurers may add, remove, or modify OD-specific previous policy fields as required and define corresponding validations based on their underwriting, regulatory, and continuity requirements.

    This section carries attributes that provide additional information for each OD policy field, such as unique identifier (id), field name, data type, input type, minimum and maximum length, default values, patterns, visibility rules, validation rules, mandatory indicators, mapping type, and system-driven expressions.

    fields object

    This section will carry attributes which provide additional information for each insurer-specific previous policy detail field (e.g., previous coverage type, previous insurer name, policy number, policy expiry date, policy expiration status, and TP/OD relationship details). It includes configurable attributes such as unique identifier (id), field name, data type, input type, minimum and maximum length, default values, pattern, visibility rules, validation rules, mandatory indicator, mapping type, and system-driven expressions, as defined by the insurer’s proposal master configuration.

    IsPreviousPolicyExpired boolean required

    Indicates whether the previous policy has been expired for more than 90 days based on the previous policy expiry date. This impacts roll-over eligibility and underwriting rules

    previousCoverageType string required

    Type of the previous motor insurance policy held (e.g., Bundled, Comprehensive, Own Damage, or Third Party). This selection impacts roll-over eligibility and policy continuity rules.

    previousPolicyInsurer string required

    Name of the insurer with whom the vehicle was previously insured. Required for roll-over cases to validate policy continuity and underwriting eligibility.

    previousPolicyNumber string required

    Possible values: >= 5 characters and <= 50 characters

    Previous motor insurance policy number of the insured vehicle. Must be between 5 and 50 characters and is required for roll-over validation and policy continuity checks.

    previousPolicyEndDate date required

    Expiry date of the previous motor insurance policy. Required for roll-over cases and must fall within the permissible continuity period as defined by the insurer.

    thirdPartyPolicyDetails object

    Section to capture previous Third Party (TP) policy details of the insured vehicle, applicable in Roll-Over cases where Own Damage (OD) and TP policies may exist separately (e.g., bundled or standalone structures).

    This includes details such as previous TP insurer name, TP policy number, TP policy start date, and TP policy expiry date.

    The structure and fields within this section are entirely driven by the insurer’s proposal master configuration. Insurers may add, remove, or modify TP-specific previous policy fields as required and define corresponding validations based on their underwriting, regulatory, and continuity requirements.

    This section carries attributes that provide additional information for each TP policy field, such as unique identifier (id), field name, data type, input type, minimum and maximum length, default values, patterns, visibility rules, validation rules, mandatory indicators, mapping type, and system-driven expressions.

    fields object

    This section will carry attributes which provide additional information for each insurer-specific previous policy detail field (e.g., previous coverage type, previous insurer name, policy number, policy expiry date, policy expiration status, and TP/OD relationship details). It includes configurable attributes such as unique identifier (id), field name, data type, input type, minimum and maximum length, default values, pattern, visibility rules, validation rules, mandatory indicator, mapping type, and system-driven expressions, as defined by the insurer’s proposal master configuration.

    IsPreviousPolicyExpired boolean required

    Indicates whether the previous policy has been expired for more than 90 days based on the previous policy expiry date. This impacts roll-over eligibility and underwriting rules

    previousCoverageType string required

    Type of the previous motor insurance policy held (e.g., Bundled, Comprehensive, Own Damage, or Third Party). This selection impacts roll-over eligibility and policy continuity rules.

    previousPolicyInsurer string required

    Name of the insurer with whom the vehicle was previously insured. Required for roll-over cases to validate policy continuity and underwriting eligibility.

    previousPolicyNumber string required

    Possible values: >= 5 characters and <= 50 characters

    Previous motor insurance policy number of the insured vehicle. Must be between 5 and 50 characters and is required for roll-over validation and policy continuity checks.

    previousPolicyEndDate date required

    Expiry date of the previous motor insurance policy. Required for roll-over cases and must fall within the permissible continuity period as defined by the insurer.

    previousPolicyQuestions object

    Section to capture additional insurer-specific previous policy related declarations and questions applicable in Roll-Over cases. This section is applicable only for Roll-Over journeys and is currently present for TAGIC insurer as per their underwriting requirements. It may include declarations related to previous add-ons, coverage selections, or continuity-based validations. This section will carry attributes that provide additional information for each insurer-specific previous policy question field, including unique identifier (id), field name, data type, input type, minimum and maximum length, default values, patterns, visibility rules, validation rules, mandatory indicators, mapping type, and system-driven expressions.

    fields object

    Fields to capture insurer-specific previous policy add-on selections such as Return to Invoice and CNG/LPG cover for roll-over underwriting validation.

    prevrtnInv boolean required

    Indicates whether the previous motor insurance policy included a Return to Invoice (RTI) cover."

    prevcngcvr boolean required

    Indicates whether the previous motor insurance policy included a CNG/LPG (bi-fuel kit) cover.

    other object required

    Section to capture additional integration or partner-related details required during the motor quote/proposal journey, such as partner redirect or thank-you URLs. The structure and fields within this section are driven by system or partner configuration and may vary based on integration requirements. This section carries attributes for each field including unique identifier (id), field name, data type, input type, minimum and maximum length, default values, patterns, visibility rules, validation rules, mandatory indicators, mapping type, and system-driven expressions.

    fields object
    partnerThankYouUrl string required

    URL (Dynamic)to which the user will be redirected after successful completion of the policy purchase journey.

    nomineeDetails object required

    Section to capture details of policy nominees and appointees (if nominee is a minor).This section will carry attributes that provide additional information for each first Life Assured personal field, such as unique identifier (id), field name, data type, input type, minimum and maximum length, default values, patterns, visibility rules, validation rules, mandatory indicators, mapping type, and system-driven expressions.

    fields object
    selectNumberOfNominees string required

    Possible values: [1]

    Total number of nominees to be added.

    fieldGroups object
    nominee1 object

    Primary Nominee details.

    firstName1 string required

    First name exactly as per valid ID Proof.

    lastName1 string required

    Last name exactly as per valid ID Proof.

    gender1 string required

    Possible values: [F, M]

    dateOfBirth1 date required

    Nominee's birth date. Age > 100 not allowed.

    relationWithLA1 string required

    Possible values: [BROTHER, BROTHERINLAW, FATHER, GRANDFATHER, GRANDSON, HUSBAND, NEPHEW, SON, UNCLE, AUNT, DAUGHTER, GRANDDAUGHTER, GRANDMOTHER, MOTHER, NIECE, SISTER, SISTERINLAW, WIFE]

    Relationship with the Life Assured (List depends on Gender).

    reason string

    Possible values: [IMMEDIATE FAMILY MEMBERS OF ADVANCED AGE, NO IMMEDIATE FAMILY MEMBER PRESENT FOR NOMINATION, NOMINATING DUE TO LOVE AND AFFECTION, NOMINEE IS DEPENDENT ON THE PROPOSER, OTHERS]

    Required if nominee is non-blood related.

    percentageShare1 integer required

    Possible values: >= 1 and <= 100

    Share percentage. Total sum of all nominees must equal 100.

    appointeeDetails1 object

    Appointee details required only if Nominee 1 is a minor (<18 years).

    firstName1 string
    lastName1 string
    gender1 string

    Possible values: [F, M]

    dateOfBirth1 date

    Appointee must be 18+ years old.

    relationWithNominee1 string

    Possible values: [BROTHER, BROTHERINLAW, FATHER, GRANDFATHER, GRANDSON, HUSBAND, NEPHEW, SON, UNCLE]

    bankDetails object
    accountType string

    Possible values: [CURRENT, SAVING]

    accountNumber string
    ifscCode string
    manufacturerId string

    Name of Manufacturer (Insurer)

    productGroupId string

    Product Group Id

    productGroupType string

    Product group type

Loading...