Using the bulk data

The datasets published by the project are made available in multiple formats, suitable for different purposes.

Please also refer to the entity structure definition and the data dictionary. Advanced users may want to learn about the statement-based data model.

Data formats

Bulk data is made available in the following formats for each data source and collection we maintain:

If you would like to discuss a custom export format for OpenSanctions that is more suitable to your needs, please get in touch.

Updates and metadata

Bulk data exports are generated in periodic intervals (every 6-8 hours) by OpenSanctions. The timestamp of the last export (and detailed metadata about the contained datasets) can be found in the metadata index (field run_time):

https://data.opensanctions.org/datasets/latest/index.json

Polling this file in regular intervals (e.g. every 30 minutes) is the best practice method for finding out if updated data has been released.


Got more questions? Our support is here to help. You can also join the Slack chat to meet the community.