About this endpoint
What it does
Searches the European Union's official Tenders Electronic Daily (TED) database and returns matching public procurement notices.
The endpoint supports filtering by keywords, countries, CPV codes, notice types, estimated contract value, publication date, language, and submission deadline. Results include tender details, contracting authority information, and links to official notices and supporting documents.
Request Body
| Parameter | Type | Description |
|---|---|---|
| keywords | String Array | Keywords used to search tender notices. |
| countries | String Array | Filter by country using ISO country codes or English country names (e.g. DE, FR, Germany). |
| cpvCodes | String Array | Filter by Common Procurement Vocabulary (CPV) codes. Broad codes also match their sub-codes. |
| noticeTypes | String Array | Notice categories to include. Allowed values: contract-notices, prior-information, contract-awards. Empty or omitted means all notice types. |
| searchIn | String | Search location. Allowed values: title, fullText. |
| language | String | Language for translated tender information. Supports 22 language codes accepted by the API. |
| maxItems | Integer | Maximum number of results to return. Minimum: 1, maximum: 100. Default: 20. |
| minValue | Number | Minimum estimated contract value. Must be greater than or equal to 0. Tenders without a published estimated value are also retained. |
| postedWithinDays | Integer | Return notices published within the specified number of days. Must be greater than or equal to 0. |
| onlyOpenTenders | Boolean | When true, returns only tenders with submission deadlines in the future. |
| includeDescription | Boolean | When true, includes the tender description where available. Default: false. |
Supported Notice Types
| Value | Description |
|---|---|
contract-notices | New contract opportunities. |
prior-information | Advance information about upcoming procurement opportunities. |
contract-awards | Notices announcing awarded contracts. |
When noticeTypes is omitted or empty, all notice types are included.
Response
Returns a JSON object containing billed, count, and items.
| Parameter | Type | Description |
|---|---|---|
| billed | Integer | Number of results charged for. |
| count | Integer | Number of matching tender records returned. |
| items | Object Array | Array of matching tender records containing the following fields. |
| items[].noticeId | String | TED's unique identifier for the tender notice. |
| items[].noticeType | String | Specific notice subtype code (e.g. cn-standard, can-modif, pin-rtl). |
| items[].noticeTypeLabel | String | Human-readable notice type (e.g. Contract notice). Currently returned in English regardless of the requested language. |
| items[].title | String | Tender title. The category portion is translated according to the language filter, while the detailed project description remains in its original language. |
| items[].titleOriginal | String | Tender title in its original language. |
| items[].mainCpv | String | Primary procurement category code. |
| items[].cpvCodes | String Array | All procurement category codes associated with the notice. |
| items[].buyerName | String | Name of the contracting authority. |
| items[].buyerCity | String or null | Buyer's city, when available. |
| items[].buyerCountry | String | Buyer's country as a three-letter country code (e.g. FRA, DEU). |
| items[].buyerEmail | String or null | Buyer's email address, when published. |
| items[].buyerWebsite | String or null | Buyer's website, when published. |
| items[].contractNature | String | Type of contract, such as works, supplies, or services. |
| items[].procedureType | String | Procurement procedure used, such as open or restricted. |
| items[].estimatedValue | Number or null | Estimated contract value. Null when not published. |
| items[].currency | String or null | Currency of the estimated contract value. |
| items[].publishedAt | String (Date) | Date when the tender notice was published. |
| items[].deadline | String (Date) or null | Tender submission deadline, when available. |
| items[].deadlineTime | String or null | Submission deadline time, when provided. |
| items[].daysLeft | Integer or null | Number of days remaining until the submission deadline. |
| items[].placeOfPerformance | String or null | Location where the contract work will be performed. |
| items[].documentsUrls | String Array | Links to supporting tender documents. |
| items[].pdfUrl | String | Link to the official PDF notice. |
| items[].xmlUrl | String | Link to the official XML notice. |
| items[].url | String | Link to the notice on the official TED website. |
| items[].scrapedAt | String (Date-Time) | Date and time when the scraper last retrieved the notice. |
| items[].source | String | Source of the tender data. Always TED. |



