Yente 4.3: New adjacent entities API

Keeping with the Friday release schedule established by 4.2.2, here comes a new release of Yente! They say once is an accident, twice is a trend, three times… Anyway, in addition to the usual routine dependency upgrades and fixes, this release includes two new endpoints to retrieve entities adjacent to a given entity (e.g. holders of an office or assets owned by a person) in a paginated way.

Adjacent entities API

This release includes a beta version of two new adjacent entities API endpoints. These APIs may still be subject to change, a production-ready stable release will be announced in the future. We would love to get your feedback, on GitHub or here on our Discourse or any other way.

The existing /entities/{entity_id}endpoint can nest adjacent entities (using the nested=true query parameter), but does so without limits of how many entities can be included. This can lead to large, slow responses when requesting entities with a large number of adjacent entities, such as institutions with many securities, or PEP positions with many holders. The /entities/{entity_id}/adjacent and /entities/{entity_id}/adjacent/{property_name} endpoints return a limited number of results by default with pagination parameters for retrieving more.

Interesting Changes

See: Release v4.3.0 · opensanctions/yente · GitHub
How to upgrade: How can I upgrade yente to the latest version? - OpenSanctions

3 Likes