The Publications Office provides a number of web application programming interfaces (APIs) related to TED and European public procurement.
These APIs let you:
- search and retrieve data published on the TED and eTendering websites
- send notices for publication
- integrate with applications used in the procurement process (currently limited to EU institutions)
Please note that although the Publications Office provides access to these APIs, we do not provide technical support on their usage.
Our APIs' registration requirements and authentication mechanisms vary according to usage and intended audience. Please read the descriptions of individual APIs for details.
Our APIs follow REST-like principles and use standard HTTP response codes. Data in requests and responses is in JSON. For almost all APIs, we provide a structured description using the OpenAPI specification version 2.0 (also known as ‘Swagger’).
When the XML content of a notice is included in a JSON payload, it is encoded in Base64 and handled as a string. This avoids any problems with characters that have a specific meaning in JSON (quotes, commas, etc.)
When we make a backwards-incompatible change, we create a new version. The version appears in each URL, for example ‘/v2/...’.
The following changes are considered to be backwards-compatible:
- adding new API operations
- adding new optional input parameters (in JSON or in the query string) to existing API methods
- adding new JSON properties to existing API responses
- changing the order of properties in existing API responses.
Recommendations for client implementations
In view of the compatibility policy described above, please make sure when implementing a client that any unexpected fields in responses are ignored. Don't rely on the order of fields in JSON.
Each HTTP request to our APIs must contain the ‘User-Agent’ header. Please specify the value for this header as accurately as possible to help us investigate potential issues.
Get published data
You can use the operations described here without registration or authentication.
From 14 November 2022, the notices available on the TED website will comply with the TED schema forms and eForms.
eForms are set out in Regulation (EU) 2019/1780 introducing new procurement standard forms. The eForms Regulation enters into force on 14 November 2022. eForms are based on the universal business language (UBL) interoperability standard. More information is available on the dedicated SIMAP page.
If you reuse TED notices, you must adapt your systems to support the new notices.
Search & retrieve notices
You can use a number of different criteria to search for procurement notices published on the TED website, and retrieve specific information for notices corresponding to your criteria. The search query is the one used for the expert search.
You can also obtain the number of notices for each geographical area (NUTS code) through a specific operation. The TED website uses this information to create the ‘Place of delivery’ map.
For details, see the API documentation.
You can also download XML notices in bulk from the TED website. A single archive contains all the notices for each day and each month.
The XML schemas used for notices and the corresponding documentation are available on the EU Vocabularies website.
A subset of data from notices published on the TED website is also available in CSV (comma-separated values) as a dataset on data.europa.eu.
View notices in various formats
Based on the content of a notice in XML, you can get the notice in HTML or PDF format, and in a specific language.
Two different APIs will be available: one to view TED schema notices, and one to view eForms notices:
- how to view TED schema notices is described in the API TED Notice Viewer documentation
- how to view eForms notices will be described in the TED eForms Notice Viewer documentation
Published calls for tenders from EU institutions
You can obtain a list of calls for tenders from EU institutions, as published on the eTendering website.
The list, which provides basic information on each call, can be filtered by:
- name of the contracting authority
- status of the call
For details, see the API documentation in PDF.
Send notices for publication
We provide operations enabling public or private bodies – known as ‘TED eSenders’ – to submit notices for publication on the TED website through their own software systems. See our page on how to become a TED eSender.
Access to these operations is restricted to eSenders and those who have applied to become eSenders. Authentication is via the "Basic" scheme, secured over HTTPS.
See the eSentool Production API documentation for details on operations for eSenders to submit notices for publication on the TED website.
We also provide the same operations on 2 other endpoints to support the process for eSender candidates:
- to simulate the publication of notices on the TED website, using the eSentool Simulation API with the corresponding API documentation
- to qualify for the publication of notices on the TED website, using the eSentool Qualification API, with the corresponding API documentation.
Integration into the procurement process
We provide various operations enabling our applications to be integrated into the wider procurement process, including:
- creating or updating a draft notice in eNotices
- obtaining information about a notice during publication
- determining the number of words and characters in a notice.
Only EU institutions currently have access to these operations. Various authentication mechanisms are available.
For details, see the API documentation.