Insurance

Get Pricing

POST/v2/calculate-insurance-pricing

Get insurance pricing for a given variant and params. List of variants and required parameters available in the section below.

Request body

variantstring

Insurance variant.

parametersobject array

Parameters required to calculate the insurance price.

namestring

Name of the parameter.

valuestring

Value of the parameter.

Returns

fullPricestring

Full insurance price.

Request Example


curl --location --request POST 'https://api-test.simpl.rent/v2/calculate-insurance-pricing' \
     --header 'Authorization: <API key>' \
     --header 'Content-Type: application/json' \
     --data-raw '{
        "variant": "tenant_insurance_basic",
        "parameters": [
          {
            "name": "liability_sum",
            "value": "100000"
          }
        ]
    }'

Issue Insurance

POST/v2/issue-insurance

Issue insurance for a given variant. Please refer to the section for available variants and required parameters.

Request body

variantstringRequired

Insurance variant.

entitiesobject arrayRequired

List of insurance entities.

typestringRequired

Type of an entity on insurance (insured | policyholder | insured_and_policyholder).

namestringOptional

Name of the entity. Required if the entity is a person.

surnamestringOptional

Surname of the entity. Required if the entity is a person.

peselNumberstringOptional

PESEL number of the entity. Required if the entity is a person and Polish citizen.

citizenshipstringOptional

Citizenship of the entity. Required if the entity is not a Polish citizen and does not have a PESEL number.

birthDatestringOptional

Birth date of the entity. Required if the entity is not a Polish citizen and does not have a PESEL number.

regonNumberstringOptional

REGON number of the entity. Required if the entity is a company.

companyNamestringOptional

Name of the company. Required if the entity is a company.

addressobjectRequired

Address of the entity.

postalCodestringRequired

citystringRequired

streetstringRequired

houseNumberstringRequired

flatNumberstringOptional

parametersobject arrayRequired

List of parameters required for the specific insurance variant (see section below).

namestringRequired

valuestringRequired

Returns

policyNumberstring

Policy number.

Request Example


curl --location --request POST 'https://api-test.simpl.rent/v2/issue-insurance' \
     --header 'Authorization: <API key>' \
     --header 'Content-Type: application/json' \
     --data-raw '{
        "variant": "tenant_insurance_basic",
        "entities": [
          {
            "type": "insured",
            "name": "John",
            "surname": "Doe",
            "peselNumber": "12345678901",
            "address": {
              "city": "Warszwa",
              "street": "Krucza",
              "houseNumber": "1",
              "flatNumber": "1",
              "postalCode": "00-000"
            }
          },
          {
            "type": "policyholder",
            "companyName": "Company Name",
            "regonNumber": "1234567890",
            "address": {
              "city": "Warszwa",
              "street": "Piwna",
              "houseNumber": "1",
              "flatNumber": "1",
              "postalCode": "00-000"
            }
          }
        ],
        "parameters": [
          {
            "name": "start_date",
            "value": "2026-01-01"
          },
          {
            "name": "liability_sum",
            "value": "100000"
          }
        ]
    }'

Cancel Insurance

POST/v2/cancel-insurance

Insurance cancellation.

Request body

policyNumberstringRequired

Policy number.

cancelAtstringRequired

Date (YYYY-MM-DD) at which insurance should be cancelled.

Request Example


curl --location --request POST 'https://api-test.simpl.rent/v2/cancel-insurance' \
     --header 'Authorization: <API key>' \
     --header 'Content-Type: application/json' \
     --data-raw '{
       "policyNumber": "TXS00000001",
       "cancelAt": "2025-01-01"
    }'

Insurance Variants

Tenant Insurance

tenant_insurance_basic

start_datestring

Start date of the insurance (YYYY-MM-DD).

liability_sumstring

Liability sum value. Required for pricing calculation.

Landlord Insurance

landlord_insurance

start_datestringDefaults to tommorow

Start date of the insurance (YYYY-MM-DD).

payment_typestringDefaults to full

Payment type of the insurance (installment | full).

rent_contract_start_datestringRequired

Start date of the rent contract (YYYY-MM-DD).

rent_contract_end_datestring

End date of the rent contract (YYYY-MM-DD) (optional if indefinite lease).

rent_sumstringRequired

Rent sum.

rent_protection_sumstringRequired

Rent guarantee sum (max 3x rent sum or 24000 PLN / min 6000 PLN). Required for pricing calculation.

simpl_rent_certificate_idstring

Simpl Rent certificate ID. Optional for pricing calculation.

property_address_citystringRequired

City of the insured property.

property_address_streetstringRequired

Street of the insured property.

property_address_house_numberstringRequired

House number of the insured property.

property_address_flat_numberstring

Flat number of the insured property.

property_address_room_numberstring

Room number of the insured property.

property_address_postal_codestringRequired

Postal code of the insured property.

cancel_atstringOptional

Date (YYYY-MM-DD) at which insurance should be cancelled.

Example Calculate Price Request


curl --location --request POST 'https://api-test.simpl.rent/v2/calculate-insurance-pricing' \
     --header 'Authorization: <API key>' \
     --header 'Content-Type: application/json' \
     --data '{
        "variant": "landlord_insurance",
        "parameters": [
            {"name": "rent_protection_sum", "value": "10000"}
        ]
     }'

Example Calculate Price Response


{
	"fullPrice": "754.00"
}

Example Calculate Price Request With Tenant Certificate


curl --location --request POST 'https://api-test.simpl.rent/v2/calculate-insurance-pricing' \
     --header 'Authorization: <API key>' \
     --header 'Content-Type: application/json' \
     --data '{
        "variant": "landlord_insurance",
        "parameters": [
            {"name": "rent_protection_sum", "value": "10000"},
            {"name": "simpl_rent_certificate_id", "value": "xyz"}
        ]
     }'

Example Calculate Price Response With Tenant Certificate


{
	"fullPrice": "754.00"
}

Example Issue Insurance Request


curl --location --request POST 'https://api-test.simpl.rent/v2/issue-insurance' \
     --header 'Authorization: <API key>' \
     --header 'Content-Type: application/json' \
     --data-raw '{
        "variant": "landlord_insurance",
        "parameters": [
            {"name": "rent_contract_start_date", "value": "2026-01-01"},
            {"name": "rent_contract_end_date", "value": "2026-01-01"},
            {"name": "simpl_rent_certificate_id", "value": "xyz"},
            {"name": "rent_sum", "value": "3000"},
            {"name": "rent_protection_sum", "value": "9000"},
            {"name": "property_address_city", "value": "Warszawa"},
            {"name": "property_address_street", "value": "Piwna"},
            {"name": "property_address_house_number", "value": "20"},
            {"name": "property_address_postal_code", "value": "00-132"}
        ],
        "entities": [
            {
                "type": "insured_and_policyholder",
                "name": "Jan",
                "surname": "Kowalski",
                "peselNumber": "12345678901",
                "address": {
                    "city": "Warszwa",
                    "street": "Krucza",
                    "houseNumber": "1",
                    "flatNumber": "1",
                    "postalCode": "00-000"
                }
            }
        ]
     }'

Example Issue Insurance Response


{
	"policyNumber": "TXW00000001"
}