You're reading version 2025-01-01, which is not the latest. The latest is 2026-04-01: see this page in 2026-04-01.

Changelog

2026-11-16

Api-Version replaces Insurely-Version

  • The API version is now sent in the Api-Version header, for example Api-Version: 2026-04-01. It takes the same values as Insurely-Version and selects the version in the same way.
  • Insurely-Version keeps working for API versions up to and including 2026-04-01, so existing integrations do not need to change straight away.
  • Versions after 2026-04-01 accept only Api-Version. A request that sends Insurely-Version with a later version returns 400.
  • Send only one of the two headers. A request that sends both returns 400.

Action: rename the header to Api-Version in your requests. Nothing else about the request or the response changes.

2026-09-24

Changes made to InsuranceChild

  • The optional field insuredPersonDateOfBirth has been added, containing the insured child's date of birth (YYYY-MM-DD).

2025-01-01

Changes made to API responses

CollectionStatus

The status ACCOUNT_TEMPORARILY_LOCKED has been added. This status indicates that the end user's access has been temporarily blocked but will be able to access their data after some time. The exact time varies for different companies but a guideline would be to try again after 15 minutes.

MonetaryAmount

The currencyCode field has changed name to currency and the type has been changed from string enum to string. The currency value is still a ISO 4217 standard currency code, however, more currencies than what is listed in the example can be added in the future.

All insurance responses

  • The type of the field discountAmount has changed from integer to MonetaryAmount.

InsuranceAnimal

  • The type of the field animalPurchasePrice has changed from integer to MonetaryAmount.
  • The type of the field veterinaryCareAmount has changed from integer to MonetaryAmount.
  • The type of the field veterinaryCareAmountRemaining has changed from integer to MonetaryAmount.

InsuranceCar

  • For the field coverage the value COMPREHENSIVE has been removed and the value THIRD_PARTY has been added. These values are now available through the holder field.
  • The field usedForWork has been removed from SwedishInsuranceCar.

InsuranceCottage

  • The type of the field insuredMovablesAmount has changed from integer to MonetaryAmount.

InsuranceFarm

  • The type of the field insuredMovablesAmount has changed from integer to MonetaryAmount.

InsuranceHome

  • The type of the field insuredMovablesAmount has changed from integer to MonetaryAmount.
  • The type of the field insuredValuablesAmount has changed from integer to MonetaryAmount. These values are now available through the holder field.

InsuranceVilla

  • The type of the field insuredMovablesAmount has changed from integer to MonetaryAmount.
  • The type of the field insuredValuablesAmount has changed from integer to MonetaryAmount.
  • The field numberOfToilets has been removed from SwedishInsuranceVilla.

InsuranceIncome

  • The type of the field insuredMonthlyAmount has changed from integer to MonetaryAmount.

InsurancePerson

  • The type of the field insuredAmountBaseEconomicalDisability has changed from integer to MonetaryAmount.
  • The type of the field insuredAmountBaseMedicalDisability has changed from integer to MonetaryAmount.
  • The type of the field insuredAmountLife has changed from integer to MonetaryAmount.
  • The type of the field insuredAmountMaxMedicalDisability has changed from integer to MonetaryAmount.