RSSChangelog

See updates across the data model, metadata structure, and API of our service. Breaking changes that require updates to data consumer applications are announced prior to their implementation.

Filter by components: Hosted API (8) · Datasets (6) · yente (6) · Data model (10) · Export formats (6) · Bulk data delivery (2) · Metadata (1)

#37 Migration of billing system to Stripe

Effective date:took effect on
Components affected:Hosted API
Announcement:

In Q4 2025, stretching into Q1 2026, we will be migrating our billing system for both API and bulk data customers from Chargebee to Stripe. This will reduce the number of moving parts in our service, as we already use Stripe to collect all credit card payments.

We hope that this change will pass unnoticed for our customers. Please bear with us if you do notice any minor hiccups during this time. In particular, customers may receive a partial service invoice for SaaS usage. Our highest priority during this migration is to never overcharge any of our customers. As always, if something doesn't look or feel right, please get in touch with our support team.

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

Effective date:took effect on
Components affected:Hosted APIyente
Announcement:

After releasing the new logic-v2 result scoring algorithm 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 with any questions regarding the new scoring algorithm.

#34 BreakingRemoval of the `cutoff` parameter to the /match endpoint

Effective date:
Components affected:yenteHosted API
Announcement:

In an effort to simplify our Matching API, we are removing the cutoff parameter. Once this change becomes effective, only matches, i.e. those results scoring higher than threshold will be returned. If you care about low-scoring results being returned, please adjust the threshold parameter instead. The match property on the returned results will remain and function as before, and match will be set to true for all results once this change becomes effective.

#32 API Service: Backend Upgrades

Effective date:took effect on
Components affected:Hosted API
Announcement:

We are planning an upgrade to the technology stack powering the OpenSanctions API in the coming days. While new functionality will be described in a separate announcement, users of the system might notice small changes in matching results. They can be a result of:

  • Improved company type suffix/prefix matching (LLC, OAO, OJSC, etc.).
  • More precise retrieval of matching candidates with very generic names (A B C Limited), and of names across different scripts (Putin and بوتين).
  • Fix of a bug in logic-v1 in which certain match scores for organizations could vary between requests.
  • Implicit support for a broader range of jurisdictions (eg. Alberta is recognized as Canada).

Of course, it is our goal to keep matching results stable over time. The result of rolling out these improvements to some of the existing matching systems, however, should strictly improve precision and reduce false positive burden for existing users.

#31 BreakingKYB/Graph API to be discontinued

Effective date:
Components affected:Hosted API
Announcement:

Effective December 31, 2025, the secondary KYB data API at api.graph.opensanctions.org will be shut down and no longer supported.

We’ve made this decision to focus on improving and expanding the core OpenSanctions dataset and API. If you are using the KYB/Graph API, please plan to transition before the end of the year. We encourage you to reach out if the impact of this change is severe for your business.

#29 BreakingMigration from features to explanations in /match responses

Effective date:
Components affected:Hosted APIyente
Announcement:

We have begun a two-step migration in the /match API response format that affects users relying on the features and matcher fields.

  1. The matcher field in /match responses will be removed after February 27, 2026. Equivalent information is available via the /algorithms route (free to use).

  2. A new explanations field has been added that is a strict superset of features. In addition to the partial scores produced by each component of the matching system, it includes textual descriptions of the matching decisions from each of these subsystems. These descriptions are designed for display in analyst workbenches or can be passed to generative AI tools to help interpret screening alerts. The features field will be removed after February 27, 2026. Users should update their applications to consume explanations before this date.

#16 BreakingRemoval of regression-v2 scoring algorithm

Effective date:took effect on
Components affected:Hosted API
Announcement:

A new version of the API will remove the regression-v2 scoring algorithm, but leave regression-v1 in place for now. regression-v2 is a historic scoring method that is discouraged for screening use (it's intended use is internal de-duplication of entities in our database).

A new regression-v3 scoring mechanism is now being developed and will be released, but not recommended for screening use. Any requests that are sent to the API using regression-v2 will be re-written to use regression-v3 in the future.

#14 yente 4.2.0

Effective date:took effect on
Components affected:yenteHosted API
Announcement:

This release updates various dependencies, introducing new fields in the followthemoney schema and bringing in security patches for the web stack dependencies.

We're also implementing the Reconciliation API's Data Extension protocol for the first time, allowing users to enrich OpenRefine tables with new columns using the API.

See more: https://github.com/opensanctions/yente/releases/tag/v4.2.0