Data Delivery Service

Our data delivery service provides the following advantages over our publicly-available data serving infrastructure:

• Reliability: In case of issues with the publicly-served data, whether technical, legal, or otherwise, we prioritize serving our licensed customers first.
• Support: When issues arise, we have better insight from our end to help debug any problems you may encounter.
• Telemetry: Understanding our customers' access patterns, clients, and dataset usage allows us to make better decisions about what work to prioritize.

Downloading data works much the same as with our publicly-served data offering, with two key differences:

The base domain is https://delivery.opensanctions.com rather than https://data.opensanctions.org. When reading the dataset metadata, the URLs in the resources section will automatically point to the data delivery service.

A data delivery token is required. You'll receive this token from us as part of the customer onboarding process. Alternatively, if you have an email address on file with us, you can find the token in the Data delivery service section of your customer portal. Please treat this token as a secret credential, and include it in the Authorization header: Authorization: Token [yoursecret].

See the yente documentation if you are running it on-premise.

Important considerations:

• Enable HTTP redirects in your client. The data delivery service uses redirects to serve large files from our CDN.
• Scope your auth headers properly: Only send the Authorization header to delivery.opensanctions.org, not to any domains it redirects to. This is the default behavior for all HTTP clients we know about.