BETA This is a trial service — your feedback will help us to improve it.

Extractives Service API

You can use this API to access data about payments made by companies in extractives industries to governments. If you are looking for any other data held by Companies House you will need to use the main Companies House API.

The data is available as either JSON or XML. In order to access a specific report filed by a registered company you will need to know the company number, and the year for which the report was filed.

If a company has made an amendment to its extractives report for a particular year then normally only the most up to date version will be returned by the API. Reports that have been amended can only be accessed through the Entity resource.

There are two endpoints which will allow you to access the data for many reports at once. The Year endpoint will allow you to access all reports filed for a given year, and the Entity endpoint will allow you to access all reports filed for a specific year for an entity.