# European Union API

> 9 public methods for European Union (europa.eu), each 1 credit per completed run.

Unofficial. Not affiliated with or endorsed by European Union.

- Page: https://fous.com/methods/europa.eu

## Methods

### [Get euro exchange rates](https://fous.com/methods/ecb.europa.eu/get-euro-exchange-rates.md)

`ecb.europa.eu/get_euro_exchange_rates`, read. Gets the official ECB euro reference exchange rates for a day, or the latest published day. Weekends, holidays and dates before publication return the previous published day.

Returns: rate date, currency names and codes, units per euro, ECB page

### [Convert currency](https://fous.com/methods/ecb.europa.eu/convert-currency.md)

`ecb.europa.eu/convert_currency`, read. Converts an amount between currencies using ECB euro reference rates, including euro and cross-currency conversions. Uses the latest preceding published rate when the date has none.

Returns: converted amount, rate, rate date, currency codes and names

### [Search EU public procurement notices](https://fous.com/methods/ted.europa.eu/search-tenders.md)

`ted.europa.eu/search_tenders`, read. Finds recently published EU procurement notices matching what is being bought, with buyer, estimated value, submission deadline and TED notice link. Open-only results must have a future submission deadline.

Returns: title, buyer, country, estimated value, currency, submission deadline, procedure type, CPV codes, TED notice link

### [Get Eurostat statistic for a country](https://fous.com/methods/ec.europa.eu/get-statistic.md)

`ec.europa.eu/get_statistic`, read. Looks up an official Eurostat statistic for an EU or EEA country and the EU27 figure for the same period. Quarterly and half-yearly series return the reporting period that contains a requested month.

Returns: country value, unit, period, EU average, dataset name, data page link, dataset code

### [Get key interest rates](https://fous.com/methods/ecb.europa.eu/get-key-interest-rates.md)

`ecb.europa.eu/get_key_interest_rates`, read. Returns the ECB's current deposit facility, main refinancing operations and marginal lending facility rates with their effective date. Optionally includes earlier rate changes, newest first.

Returns: effective date, deposit facility rate, main refinancing rate, marginal lending rate, page URL, optional rate history

### [Validate EU VAT number](https://fous.com/methods/ec.europa.eu/validate-vat-number.md)

`ec.europa.eu/validate_vat_number`, read. Checks an EU VAT number in the European Commission's VIES service and returns whether it is valid, with the registered name and address when the country makes them available.

Returns: valid, country, vat_number, registered_name, address, checked_at, note

### [Search EU contract awards](https://fous.com/methods/ted.europa.eu/search-contract-awards.md)

`ted.europa.eu/search_contract_awards`, read. Finds published EU contract award notices on Tenders Electronic Daily by contract topic or winning company, newest publication first, optionally limited to a buyer country and a start date. Values and tender counts are included when published; counts across lots are summed.

Returns: contract title, buyer, buyer country, winners, awarded value, currency, tenders received, publication date, notice link, CPV codes

### [Get EU law article](https://fous.com/methods/eur-lex.europa.eu/get-law-article.md)

`eur-lex.europa.eu/get_law_article`, read. Gets the official text and key dates of one article of an EU regulation or directive from EUR-Lex, in the latest consolidated version when there is one, in any official EU language.

Returns: official title, short name, article title and text, document, entry-into-force and application dates, in-force status, version, link, CELEX number

### [Search EU law](https://fous.com/methods/eur-lex.europa.eu/search-eu-law.md)

`eur-lex.europa.eu/search_eu_law`, read. Searches EUR-Lex legal acts by topic, ranked by the site's relevance, filtered by document type, year of adoption and in-force status. Short names and ELI links are included when shown in the results.

Returns: title, short name, document type and number, date, in-force status, author, link, CELEX number, ELI link