Release 1.4.0 (2025-11-25)

• Change API to TypeSpec as source of truth.
• Change generated libraries to openapi-generator version 7 with modified templates (see templates directory).
  • PHP
    • Minimal changes in the use of the library.
  • Python
    • Imports have changes, all models and apis are in separate modules and some have moved for example api.model -> api.models and api.apis -> api.api.
    • Model members are now snake_case.
    • Enums are now derived from enum.Enum.
    • JsonPatchDocument has been replaced with list[Operation].
    • Files are now returned as plain bytearray.
  • C#
    • New library is generic host based, so Configuration class has been removed and more. See the new example on how to use the client with tokens.
    • Uses System.Text.Json for JSON processing
    • JsonPatchDocument, Operation and OperationType were dropped and now use the models from Microsoft.AspNetCore.JsonPatch
    • ValidationProblemDetails and ProblemDetails were dropped and now use the models from Microsoft.AspNetCore.Mvc.Core
    • Sync versions of operations been removed, added Events based alternative
• Add taxatieorganisatieWeergave to Taxatiedata model.
• Added geenEigenBewoning and incorrecteErfpacht values to BusinessRulesCode.

Release 1.4.0-rc4 (2025-11-12)

• Disabled seal-object-schemas TypeSpec emitter option.
• Added geenEigenBewoning and incorrecteErfpacht values to BusinessRulesCode.

Release 1.4.0-rc3 (2025-10-28)

• Add taxateurorganisatieWeergave to Taxatiedata model.

Release 1.4.0-rc2 (2025-10-02)

• Updated code formatting.
• Update client generation tooling and templates.

Release 1.4.0-rc1 (2025-07-01)

• Change API to TypeSpec as source of truth.
• Change generated libraries to openapi-generator version 7 with modified templates (see templates directory).
  • PHP
    • Minimal changes in the use of the library.
  • Python
    • Imports have changes, all models and apis are in separate modules and some have moved for example api.model -> api.models and api.apis -> api.api.
    • Model members are now snake_case.
    • Enums are now derived from enum.Enum.
    • JsonPatchDocument has been replaced with list[Operation].
    • Files are now returned as plain bytearray.
  • C#
    • New library is generic host based, so Configuration class has been removed and more. See the new example on how to use the client with tokens.
    • Uses System.Text.Json for JSON processing
    • JsonPatchDocument, Operation and OperationType were dropped and now use the models from Microsoft.AspNetCore.JsonPatch
    • ValidationProblemDetails and ProblemDetails were dropped and now use the models from Microsoft.AspNetCore.Mvc.Core
    • Sync versions of operations been removed, added Events based alternative

Release 1.3.1 (2024-05-14)

• Add DeelWaarderingWebhookPayload model.
• Use of strings for CBS codes.
  • Add buurtCode field to CbsIndeling model.
  • Allow for string input for endpoint buurt.
• Add UserAgent header to callback requests with format: CalcasaPublicAPI/<version>

Release 1.3.0 (2023-10-24)

• Add geldverstrekker field to the CallbackInschrijving model.
• Add support for mTLS on the callback service.
  • By default when requested by the target server the public CA signed TLS certificate with the appropriate domain as Common Name will be offered as the client certificate.
  • Public TLS Certificates rotate every couple of months.
• Change a couple of date-time fields that only contained a date to pure date fields. This might result is a different type in the generated clients and the service-side validation will be more strict. Times included in values will no longer be silently dropped, but will generate an error.
  • Change Modeldata model waardebepalingsdatum field to type date in OpenAPI spec.
  • Change Bestemmingsdata model datumBestemmingplan field to type date in OpenAPI spec.
  • Change Bodemdata model datumLaatsteOnderzoek field to type date in OpenAPI spec.
  • Change Referentieobject model verkoopdatum field to type date in OpenAPI spec.
  • Change VorigeVerkoop model verkoopdatum field to type date in OpenAPI spec.
  • Change waarderingInputParameters model peildatum field to type date in OpenAPI spec. This is an input field and will now require a date without a time.
• Add desktopTaxatieHerwaardering product to enumeration ProductType.
• The service no longer returns CORS headers.
• Actions now correctly report the 'application/problem+json' Content-Type in the documentation for the HTTP 422 Unprocessable Entity responses.
• Added energielabelData field to Objectdata model to contain the extra information about the energy label.
• The OpenAPI spec generation was changed slightly and thus the generated and published clients might be affected. There might be some slight breaking changes at compile time, but the functionality remains the same.
  • For example for

Release 1.2.1 (2023-04-17)

• Add externeReferentie field to the CallbackInschrijving and WaarderingWebhookPayload models.

Release 1.2.0 (2022-08-04)

• Add support for managing CallbackSubscription's, this allows you to subscribe to callbacks for valuations that were not created with your API client.
  • GET /v1/callbacks/inschrijvingen
  • POST /v1/callbacks/inschrijvingen
  • GET /v1/callbacks/inschrijvingen/{bagNummeraanduidingId}
  • DELETE /v1/callbacks/inschrijvingen/{bagNummeraanduidingId}
• Add taxateurnaam field to the Taxatiedata model.
• Callback URIs should now end in / not just contain it to help stop common errors (ending in = is also still allowed when using a query string).
• Updating configuration in the POST /v1/configuratie/callbacks endpoint now clears stored but decommissioned versions from the configuration object.
• Add klantkenmerk to the WaarderingInputParameters and Waardering models.

Release 1.1.7 (2022-07-12)

• Added support for the OAuth 2.0 authorization code flow for use of the API with user accounts.
• Add Bouweenheid to FunderingSoortBron enumeration.