Developers' corner for eSenders and Reusers

The Publications Office provides a number of web application programming interfaces (APIs) related to TED and European public procurement.

These APIs let you:

enlightened Please note that although the Publications Office provides access to these APIs, we do not provide technical support on their usage.


General information

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.

TED schema forms are set out in Regulation (EU) 2015/1986 and are based on an interoperability standard of the Publications Office. Documentation is available on the EU Vocabularies website.

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
Search via the user interface

You can search for specific procurement notices by using the search engine on the TED website. The search function to use is the 'expert search', which can filter and retrieve notices corresponding to a number of different criteria.

The TED website also allows you to search for information on the number of notices for each geographical area (NUTS code), and can provide this information in the form of a ‘place of performance’ map.

As the eForms Regulation introduces a new TED schema, some search criteria will need to be adapted. The API documentation will introduce a search-controller-v3 to search both TED schema notices and eForms notices. You will therefore need to adapt your systems to support the new notices. For details, see Adapt expert search query for eForms notices.

XML bulk download

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.

For current standard forms, the XML schemas used for notices, along with the corresponding documentation, are available on the EU Vocabularies website.

For eForms, more information is available on the SIMAP page.

CSV files

A subset of data from notices published on the TED website is also available in CSV (comma-separated values) as a dataset on

Adapt expert search query for eForms notices

As the eForms Regulation introduces a new TED schema, some search criteria for TED notices will need to be adapted.

The search codes will be based on the authority tables used for eForms (notice type, legal basis, buyer legal type, etc.).

To search a notice by ‘business opportunities’, the search field ‘notice type’ (notice-type) will be used instead of the field ‘document type’ (TD). Code values will be those of the authority table notice-type on GitHub eForms-SDK.

To search a notice based on the search fields ‘Country’(CY) and ‘Languages in which tenders may be submitted’ (SUB_LG) users will have to use 3-letter codes instead of 2-letter codes.

Extension of the notice publication number to 8 digits

The TED website currently allows a maximum of 999.999 notices to be published per year (i.e. 6 digits, e.g. 1-2022, 654321-2022).

To enable more than one million notices to be published per year, we have increased the publication number to 8 digits (e.g. 1-2024, 87654321-2024).

Due to this extension, the XML packages will contain two formats of the XML files:

  • for eForms notices the format will have 8 digits (e.g. 00654321_2022.xml)
  • for TED schema notices the format XML file will have 6 digits (e.g. 123456_2022.xml).

The publication number will have 8 digits for eForms notices and 6 digits for TED schema notices.

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
  • language.

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 Acting as a TED eSender.


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.