Developers' corner

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.)

Versioning

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.

The Latest News section below describes all the latest changes in our APIs.

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.

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 the EU Open Data Portal.

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.

For details, see the API 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 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.

Latest news

15/09/2019: New version of the TED website search API

A new version of the TED website search API is now available, under the URL prefix ‘https://ted.europa.eu/api/v2.0’. The new version was necessary because we had to introduce some non-backwards-compatible changes.

Changes

  • Operations under ‘/api/latest’ have been removed.
  • The API key is no longer required.
  • The "ND" and "OJ" fields in search results are now indicated as string (instead of integer), reflecting their actual content.

Improvements

  • New operation to retrieve the number of notices for each geographical area (NUTS code).
  • Various improvements in the OpenAPI documentation.