---
title: "Adopt logic-v2 as the API default result scoring algorithm"
url: "https://www.opensanctions.org/changelog/35/"
id: "35"
date_created: "2025-09-17T08:30:56.565Z"
date_effective: "2025-12-01"
breaking: false
categories: ["Hosted API","yente"]
---

# Adopt logic-v2 as the API default result scoring algorithm

After releasing the new [`logic-v2` result scoring algorithm](https://www.opensanctions.org/articles/2025-09-11-logic-v2/) in September, we're planning to make it the default used by the OpenSanctions API service when no other algorithm is specified (or the `best` algorithm is selected). API users can prepare for this change in two ways: 

* Adopt `logic-v2`. The new system significantly reduces false positive alert rates and improves match quality. We also plan to make this new algorithm the focus of future feature enhancements and precision improvements. 
* Specify `algorithm=logic-v1` as part of your query string to **opt out of this change**. This will freeze the use of `logic-v1`, the current `best`/default algorithm. This option is recommended for API users where scoring changes may require a regulatory approval/notification. We may choose to fully retire `logic-v1` within the next 24 months.

Please feel free to reach out to [the support team](/support/) with any questions regarding the new scoring algorithm.
