Data and API documentation

Data outputs

The UK is committed to open contracting. Notice data is available under the Open Government Licence.


OCDS API

You can download notices in Open Contracting Data Standard (OCDS) JSON format using our API. Notice fields are mapped to OCDS version 1.1.5 with extensions as defined by the Open Contracting Partnership.



XML downloads

The same notice data is also available to download from the data.gov.uk website or using their API. Daily Zip files contain an XML file for each notice.



Publication XML schema downloads

Current schema - may be used for notices published from 2 March 2021:



Previous schema - may be used for notices published to 3 May 2021:



Note that from 2 March to 3 May 2021 notices may use either schema.


Find a Tender XML formats are based on those used by Tenders Electronic Daily (TED). See details of the changes from TED and between versions on Find a Tender.


Data inputs

Licensed data providers (eSenders) can send us notices using the methods and formats described. To become a data provider, contact us.


API submission


Email submission


Reception XML schema downloads


Find a Tender XML formats are based on those used by Tenders Electronic Daily (TED). See details of the changes from TED and between versions on Find a Tender.