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

▸projectIdstringOptional

Optionally specifies the target project for the insurance. If the provided ID (unique per organization) does not exist, the system creates a new project record with that identifier.

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

Fields

▸

▸start_datestring

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

▸liability_sumstring

Liability sum value. Required for pricing calculation.

Landlord Insurance

landlord_insurance

Fields

▸

▸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"
}