Skip to content

Public tender API

Tendova publishes the tender data it collects from TED as a read-only JSON API. It is free, needs no key to try, and returns the same notices the website shows.

What the API returns

Two endpoints, both JSON, both read-only.

  • GET /api/tenderssearches active tenders by full text, country, CPV code and sort order, and returns one page of results plus pagination.
  • GET /api/tenders/{id} returns one tender in full: buyer, CPV codes, place of performance, estimated value, deadlines and the official source links.
  • Titles and descriptions come back in any of the 24 official EU languages through the locale parameter.

AI summaries, match scores, fit checks and document analysis are never part of an API response. Those stay inside the product.

Authentication

No key is needed to try the API. Send one as soon as you build on it: keys are free on every plan and raise your budget. Either header works.

Authorization: Bearer tdv_live_…
X-Api-Key: tdv_live_…

An unknown, malformed or revoked key is rejected with HTTP 401 and the error code invalid_api_key. Sending no key at all is an anonymous call, not an error.

Create a key in your account

Rate limits

CallerRequest budgetRecords per request
No key20 requests per minute, per IP addressup to 20
Key on the Free plan500 requests per day, per keyup to 20
Key on the Pro plan10,000 requests per day, per keyup to 50

Keyed calls also pass a burst guard of 60 requests per minute, so a daily budget cannot be spent in one go.

Every response carries x-ratelimit-limit and x-ratelimit-remaining. A call over the limit returns HTTP 429 with retry-after in seconds.

Examples

Search tenders

curl -s "https://tendova.eu/api/tenders?q=software&country=DE&limit=20&locale=en" \
  -H "Authorization: Bearer tdv_live_YOUR_KEY"

Fetch one tender

curl -s "https://tendova.eu/api/tenders/{id}?locale=en" \
  -H "Authorization: Bearer tdv_live_YOUR_KEY"

Leave the Authorization header out to call anonymously. Every list item carries an apiUrl field: the detail URL for that tender, ready to fetch.

For AI agents

A short orientation file describes the same endpoints in the llmstxt.org format, for coding assistants and agent frameworks.

Open llms.txt

Where the data comes from

All notices come from Tenders Electronic Daily (TED), the official procurement journal of the EU. Tendova adds translation, structure and search on top; the notices themselves stay public data.

Contains data from Tenders Electronic Daily (TED), © European Union, ted.europa.eu — CC BY 4.0.

For bulk or commercial data access, write to [email protected].