Aurelmark API

Returns one EU contract award notice from official TED by its publication number: winners, buyer, value, CPV, dates, lots, notice URL and SHA-256 proof. Use it when you already have a notice_id; use awards_list_contracts to discover awards or filter by company, CPV or country. Input: notice_id (required, TED publication number, 1 to 8 digits, hyphen, year, e.g. 718666-2026). Output: award and feed (coverage, checked_at). A notice we have not stored returns award_not_found; awards_feed_not_ready means the feed is not loaded yet. Reads stored observations (about 45 days), not a live TED lookup. Terms: read-only; MCP calls are never charged. Without a key, metered routes give 10 successful answers a day free, as short samples (up to 3 records, without file proof, history or paging cursor) where a paid HTTP address exists (unmetered routes are unlimited); errors do not count. On the paid HTTP routes, errors are free, and so are empty answers except a sanctions name search with no match when every loaded list it checks is fresh (lists not loaded yet are named in the answer). An optional API key keeps its prepaid-credit policy. When the free answers run out, the error names the HTTP alternative.

Returns EU public-contract winners from official TED (Tenders Electronic Daily) award notices published since a date: who won, which buyer, value, CPV and lots. Use it to find new awards or what a company has won; use awards_get_contract for one known notice, and tenders_list_deadline_changes for open tender deadlines, not winners. Inputs (all optional, they narrow together): since (YYYY-MM-DD, default 7 days ago; about 45 days are kept), cpv (up to 5 comma-separated CPV prefixes of 2 to 8 digits, e.g. 72 for IT services), country (buyer, 3-letter ISO code as TED uses, e.g. DEU), winner (name prefix, at least 3 letters, e.g. Mennica Polska), winner_id (exact official id, e.g. PL1234567890), limit (1 to 50, default 20) and cursor (next_cursor, same filters). Output: awards[] with winners, buyer, value, CPV, dates, lots, notice URL and SHA-256 proof, plus count, has_more, next_cursor and feed (checked_at, coverage). Stored observations, not a live TED search; check feed.checked_at. Terms: read-only; MCP calls are never charged. Without a key, metered routes give 10 successful answers a day free, as short samples (up to 3 records, without file proof, history or paging cursor) where a paid HTTP address exists (unmetered routes are unlimited); errors do not count. On the paid HTTP routes, errors are free, and so are empty answers except a sanctions name search with no match when every loaded list it checks is fresh (lists not loaded yet are named in the answer). An optional API key keeps its prepaid-credit policy. When the free answers run out, the error names the HTTP alternative.

Returns the latest official CBAM certificate price published by the European Commission (EUR per certificate, one tonne CO2e) with its period, publication date and history. Use it when you only need the price; use cbam_get_default_values for a product's emissions and estimated cost, which already includes this price. No inputs. Output: unit, latest (period, price, published), history[], next expected publication and Commission source links. The Commission publishes quarterly in 2026 and weekly from 2027; we copy each publication, so check latest.published rather than treating it as a live market quote. Terms: read-only; MCP calls are never charged. Without a key, metered routes give 10 successful answers a day free, as short samples (up to 3 records, without file proof, history or paging cursor) where a paid HTTP address exists (unmetered routes are unlimited); errors do not count. On the paid HTTP routes, errors are free, and so are empty answers except a sanctions name search with no match when every loaded list it checks is fresh (lists not loaded yet are named in the answer). An optional API key keeps its prepaid-credit policy. When the free answers run out, the error names the HTTP alternative.

Returns official CBAM default embedded emissions (tCO2e per tonne) for a CN/TARIC code, origin country and year, from the Commission's implementing act, with markup, gross EUR per tonne and the certificate price used. Use it to estimate CBAM cost for a product; use cbam_get_certificate_price for the price alone and cbam_list_countries to see which countries have their own table. Inputs: cn (required, CN/TARIC code or prefix, 2 to 10 digits, spaces and dots ignored, e.g. 7208 or 2523900010), country (optional, two-letter ISO code such as IN, default OTHER; UNKNOWN selects the Annex IV precursor values) and year (optional, 2026 to 2100, default the current year). A prefix expands to at most 100 matches; truncated says rows were left out. Output: matches[] with code, description, direct emissions, markup, gross EUR per tonne, plus certificate_price and regulation sources. Indirect emissions and electricity are excluded. A code outside CBAM returns the error not_a_cbam_good. Values are bundled from the cited acts, not live CBAM Registry figures. Covers 283 CN codes and 121 country tables from Implementing Regulation (EU) 2026/1740, which replaced the 2025/2621 annexes; mark-up 10% for 2026, 20% for 2027, 30% from 2028; 1% for fertilisers. Terms: read-only; MCP calls are never charged. Without a key, metered routes give 10 successful answers a day free, as short samples (up to 3 records, without file proof, history or paging cursor) where a paid HTTP address exists (unmetered routes are unlimited); errors do not count. On the paid HTTP routes, errors are free, and so are empty answers except a sanctions name search with no match when every loaded list it checks is fresh (lists not loaded yet are named in the answer). An optional API key keeps its prepaid-credit policy. When the free answers run out, the error names the HTTP alternative.

Returns the origin countries that have their own table in the official CBAM default-values act, as ISO code and name, with the regulation source. Use it to pick a country code before calling cbam_get_default_values; it returns no emission values itself, and countries not listed use OTHER there. No inputs. Output: countries[] (code, name) and source. Changes only when the bundled official act is updated. Terms: read-only; MCP calls are never charged. Without a key, metered routes give 10 successful answers a day free, as short samples (up to 3 records, without file proof, history or paging cursor) where a paid HTTP address exists (unmetered routes are unlimited); errors do not count. On the paid HTTP routes, errors are free, and so are empty answers except a sanctions name search with no match when every loaded list it checks is fresh (lists not loaded yet are named in the answer). An optional API key keeps its prepaid-credit policy. When the free answers run out, the error names the HTTP alternative.

Returns one statutory EU compliance deadline by its exact id, with the Official Journal source, quote, SHA-256 and dated history of changes. Use it when you already have an id from compliance_list_deadlines; use compliance_list_deadlines to search by law or dates or to get several at once. Input: id (required, 1 to 80 lowercase letters/digits/hyphens, case-sensitive, e.g. eudr-large-medium-operators). Output: as_of, verified and deadline with obligation, date, previous_date, status, days_until, source URL, quote, SHA-256 and history. An unknown id returns the error deadline_not_found. Data is bundled from the acts and reviewed as of verified; days_until is computed today. 26 obligations under 12 laws from 19 acts; 11 dates have moved through 7 amending acts, each earlier date kept in history with its act, article and quote. Terms: read-only; MCP calls are never charged. Without a key, metered routes give 10 successful answers a day free, as short samples (up to 3 records, without file proof, history or paging cursor) where a paid HTTP address exists (unmetered routes are unlimited); errors do not count. On the paid HTTP routes, errors are free, and so are empty answers except a sanctions name search with no match when every loaded list it checks is fresh (lists not loaded yet are named in the answer). An optional API key keeps its prepaid-credit policy. When the free answers run out, the error names the HTTP alternative.

Returns statutory EU compliance dates (CBAM, EUDR and other laws) with the Official Journal source, quote and SHA-256 for each. Use it to browse or filter deadlines and to find ids; use compliance_get_deadline for one known id, tenders_list_deadline_changes for tender submission deadlines and funding_list_changes for grant call deadlines. Inputs (all optional, they narrow together): law (name from the returned laws list, case-insensitive, e.g. CBAM), status (upcoming or applies), from and to (YYYY-MM-DD). With no filters it returns every date, ordered by date then id, without paging. Output: as_of, verified, count, laws[] and deadlines[] with id, law, obligation, date, days_until, status, source URL, quote, SHA-256 and history. Data is bundled from the acts and reviewed as of verified; days_until is computed today. 26 obligations under 12 laws from 19 acts; 11 dates have moved through 7 amending acts, each earlier date kept in history with its act, article and quote. Terms: read-only; MCP calls are never charged. Without a key, metered routes give 10 successful answers a day free, as short samples (up to 3 records, without file proof, history or paging cursor) where a paid HTTP address exists (unmetered routes are unlimited); errors do not count. On the paid HTTP routes, errors are free, and so are empty answers except a sanctions name search with no match when every loaded list it checks is fresh (lists not loaded yet are named in the answer). An optional API key keeps its prepaid-credit policy. When the free answers run out, the error names the HTTP alternative.

Returns whether one CN/HS/TARIC code is covered by the EU Deforestation Regulation (EUDR) Annex I, with the matching product lines and official sources. Use it to check a single code; use eudr_list_products to browse the whole Annex I catalogue, and cbam_get_default_values for CBAM, a different law. Input: cn (required, code or prefix, 2 to 10 digits, spaces and dots ignored, e.g. 0901 for coffee). Output: verdict (yes, partly, some_codes_below, applies_later or no), in_scope, meaning, matches[], upcoming[], removed products, applies_from, sources and verified. Annex I as amended by Delegated Regulation (EU) 2026/2102: cattle hides, skins and leather (4101, 4104, 4107) are removed (verdict no, with removed set); products it adds, such as soluble coffee 2101 11 00, apply only from 2027-12-30 and give applies_later with upcoming[]. some_codes_below means a longer code is needed; partly means an ex line where only the described goods are covered. Bundled from the official acts and reviewed as of verified; this is scope information, not a due-diligence statement. Terms: read-only; MCP calls are never charged. Without a key, metered routes give 10 successful answers a day free, as short samples (up to 3 records, without file proof, history or paging cursor) where a paid HTTP address exists (unmetered routes are unlimited); errors do not count. On the paid HTTP routes, errors are free, and so are empty answers except a sanctions name search with no match when every loaded list it checks is fresh (lists not loaded yet are named in the answer). An optional API key keeps its prepaid-credit policy. When the free answers run out, the error names the HTTP alternative.

Returns the full EU Deforestation Regulation (EUDR) Annex I product catalogue: each commodity with its CN codes and descriptions, from the official acts. Use it to browse what is covered; use eudr_check_scope to test one code and get a clear verdict. No inputs; no paging. Output: products[] (commodity, codes, descriptions; lines added by Delegated Regulation (EU) 2026/2102 carry applies_from 2027-12-30), removed products, applies_from dates, official sources and verified. Ex lines cover only the described goods, not everything under the code. Bundled from the official acts and reviewed as of verified. Terms: read-only; MCP calls are never charged. Without a key, metered routes give 10 successful answers a day free, as short samples (up to 3 records, without file proof, history or paging cursor) where a paid HTTP address exists (unmetered routes are unlimited); errors do not count. On the paid HTTP routes, errors are free, and so are empty answers except a sanctions name search with no match when every loaded list it checks is fresh (lists not loaded yet are named in the answer). An optional API key keeps its prepaid-credit policy. When the free answers run out, the error names the HTTP alternative.

Returns changes to open and forthcoming EU grant calls on the official EU Funding & Tenders Portal: new calls, moved deadlines, status changes and removals, with before/after records. Use it to follow EU grants; use tenders_list_deadline_changes for procurement tenders and compliance_list_deadlines for legal compliance dates. Inputs (all optional, they narrow together): since (YYYY-MM-DD, default 7 days ago), change (added/amended/removed), field (which field changed, e.g. deadlines), identifier (topic or call id prefix, 2 to 200 characters, e.g. HORIZON-CL5-2026), limit (1 to 50, default 20) and cursor (next_cursor, same filters). Output: changes[] with before and after topic records, official topic URL and observed_at, plus count, has_more, next_cursor and feed check time; the Portal is checked about every 6 hours. A change feed, not a catalogue of all open calls. For one topic's current record use HTTP GET /v1/eu/funding/topics/{id} (see /openapi.json). Terms: read-only; MCP calls are never charged. Without a key, metered routes give 10 successful answers a day free, as short samples (up to 3 records, without file proof, history or paging cursor) where a paid HTTP address exists (unmetered routes are unlimited); errors do not count. On the paid HTTP routes, errors are free, and so are empty answers except a sanctions name search with no match when every loaded list it checks is fresh (lists not loaded yet are named in the answer). An optional API key keeps its prepaid-credit policy. When the free answers run out, the error names the HTTP alternative.

Returns one current entry from the official US, UK, EU or Canada sanctions list (Canada entity-only; Australia pending, not loaded yet) by list and exact id, with proof of the official file it came from. Use it after sanctions_search_entries or sanctions_list_changes gave you an id; use sanctions_search_entries to match a name and sanctions_list_changes to see why an entry was removed. Inputs: list (required: ofac-sdn, ofac-consolidated, uk, eu, ca or au) and id (required, 1 to 40 letters/digits/._-, e.g. RUS0849 on uk or 36 on ofac-sdn). Output: entry with names, aliases, programmes, countries, first_seen and last_changed, and proof (official file URL, SHA-256, source date). An unknown or removed id returns the error entry_not_listed. Reads stored snapshots refreshed about every 6 hours; a monitoring feed, not a real-time clearance decision. Terms: read-only; MCP calls are never charged. Without a key, metered routes give 10 successful answers a day free, as short samples (up to 3 records, without file proof, history or paging cursor) where a paid HTTP address exists (unmetered routes are unlimited); errors do not count. On the paid HTTP routes, errors are free, and so are empty answers except a sanctions name search with no match when every loaded list it checks is fresh (lists not loaded yet are named in the answer). An optional API key keeps its prepaid-credit policy. When the free answers run out, the error names the HTTP alternative.

Returns additions, amendments and removals between official sanctions list snapshots: US Treasury OFAC SDN and Consolidated, UK HM Treasury/FCDO, EU Financial Sanctions Files and Canada (Canada coverage is entity-only; Australia pending, not loaded yet). Use it to monitor what changed since a date; use sanctions_search_entries when you have a name, and sanctions_get_entry when you already know a list and id. Inputs (all optional, they narrow together): since (YYYY-MM-DD, default 7 days ago), list, change (added/amended/removed), limit (1 to 50, default 20) and cursor (next_cursor from the previous page, same filters). Output: changes[] with entry, changed fields, observed_at and proof (official file URL, SHA-256, source date), plus lists[] check times and next_cursor for paging or polling; lists are checked about every 6 hours. This is a monitoring feed, not a clearance decision: no change means none observed, the UN list is not covered, and the official publications are authoritative. Changes are found by comparing each official file with a stored earlier copy, history from 2026-10-22; rebuilding it means about 55 MB of XML in 4 schemas, and changes before a first copy cannot be recovered. Terms: read-only; MCP calls are never charged. Without a key, metered routes give 10 successful answers a day free, as short samples (up to 3 records, without file proof, history or paging cursor) where a paid HTTP address exists (unmetered routes are unlimited); errors do not count. On the paid HTTP routes, errors are free, and so are empty answers except a sanctions name search with no match when every loaded list it checks is fresh (lists not loaded yet are named in the answer). An optional API key keeps its prepaid-credit policy. When the free answers run out, the error names the HTTP alternative.

Returns current entries on the official OFAC (SDN and Consolidated), UK, EU and Canada sanctions lists (Canada entity-only; Australia pending, not loaded yet) whose name or alias has a word starting with each word you give, in any order, ignoring case, accents and punctuation; if nothing matches, a one- or two-letter typo in words of 4 or more letters, except the first letter, is tolerated. When more than 2000 rows share your words, has_more is true and candidates_truncated is set: add words or a list. Use it when you have a name; use sanctions_get_entry for a known list and id, and sanctions_list_changes to watch what changed. Inputs: name (required, at least 3 letters/digits and at most 6 words, e.g. Rosneft or Ivanov Sergey), list (optional, one list) and limit (1 to 50, default 20; no paging, so narrow name or list when has_more is true). Output: matches[] with list, id, names, aliases, score (0 to 1), matched_name, match_type (exact_words or fuzzy), programmes, countries, first_seen and last_changed, plus has_more and lists[] with official file URLs and check times (about every 6 hours). This is a monitoring aid, not a clearance decision: no match does not clear anyone, the UN list is not covered, and the official lists are authoritative. Terms: read-only; MCP calls are never charged. Without a key, metered routes give 10 successful answers a day free, as short samples (up to 3 records, without file proof, history or paging cursor) where a paid HTTP address exists (unmetered routes are unlimited); errors do not count. On the paid HTTP routes, errors are free, and so are empty answers except a sanctions name search with no match when every loaded list it checks is fresh (lists not loaded yet are named in the answer). An optional API key keeps its prepaid-credit policy. When the free answers run out, the error names the HTTP alternative.

Returns submission-deadline changes for one watched TED tender, from its official TED notices: each event per lot with old and new deadline (local and UTC), plus the current deadlines. Use it after tenders_list_watched gave you a notice_id; use funding_list_changes for grant calls and compliance_list_deadlines for legal dates. Inputs: notice_id (required, TED publication number, e.g. 662865-2026), limit (1 to 50, default 50) and cursor (next_cursor to page or checkpoint_cursor to poll later; cursors belong to that notice and expire after 24 hours). Output: events[] with lot, old and new deadlines and the TED notice link, current deadlines, cursors and freshness (checked hourly). A notice we do not watch returns notice_not_tracked. Terms: read-only; MCP calls are never charged. Without a key, metered routes give 10 successful answers a day free, as short samples (up to 3 records, without file proof, history or paging cursor) where a paid HTTP address exists (unmetered routes are unlimited); errors do not count. On the paid HTTP routes, errors are free, and so are empty answers except a sanctions name search with no match when every loaded list it checks is fresh (lists not loaded yet are named in the answer). An optional API key keeps its prepaid-credit policy. When the free answers run out, the error names the HTTP alternative.

Returns the official TED (Tenders Electronic Daily) tenders we monitor for submission-deadline changes, with each one's notice_id, last check time and freshness. Use it first to find a notice_id for tenders_list_deadline_changes; use awards_list_contracts for contract winners. No inputs. It does not add a watch (ask [email protected]). Output: the watched notices with their notice_id values, last check times and freshness, as /v1/coverage reports them (checked hourly). Always free and unlimited, no key needed. Terms: read-only; MCP calls are never charged. Without a key, metered routes give 10 successful answers a day free, as short samples (up to 3 records, without file proof, history or paging cursor) where a paid HTTP address exists (unmetered routes are unlimited); errors do not count. On the paid HTTP routes, errors are free, and so are empty answers except a sanctions name search with no match when every loaded list it checks is fresh (lists not loaded yet are named in the answer). An optional API key keeps its prepaid-credit policy. When the free answers run out, the error names the HTTP alternative.

Returns EU anti-dumping, countervailing, safeguard and steel regulations published in the Official Journal (EUR-Lex), with products, origin countries and the CN/TARIC codes they name. Use it to find trade defence actions on a product or country; use trade_list_quotas for tariff quota volumes, and TARIC for binding duty rates and quota balances. Inputs (all optional, they narrow together): cn (CN/TARIC code, 4 to 10 digits, e.g. 7208; matches broader and narrower codes on the first 8 digits), since (YYYY-MM-DD), instrument, action, country (origin name part, e.g. China), limit (1 to 50, default 20) and cursor (next_cursor, same filters). Output: measures[] with celex, title, action, instrument, products, origin countries, CN/TARIC codes, EUR-Lex URL and observed_at, plus next_cursor and feed freshness; EUR-Lex is checked twice a day. Extracted codes are not a binding duty rate. For one act use HTTP GET /v1/eu/trade-defence/measures/{celex} (see /openapi.json). Terms: read-only; MCP calls are never charged. Without a key, metered routes give 10 successful answers a day free, as short samples (up to 3 records, without file proof, history or paging cursor) where a paid HTTP address exists (unmetered routes are unlimited); errors do not count. On the paid HTTP routes, errors are free, and so are empty answers except a sanctions name search with no match when every loaded list it checks is fresh (lists not loaded yet are named in the answer). An optional API key keeps its prepaid-credit policy. When the free answers run out, the error names the HTTP alternative.

Returns EU steel and safeguard tariff quota rows taken from the tables of official Official Journal acts: order number, product, CN codes, country, tonnes per period and out-of-quota duty. Use it for allocated quota volumes; use trade_list_measures for the regulations themselves, and TARIC for live remaining balances. Inputs (all optional, they narrow together): cn (CN/TARIC code, 4 to 10 digits, e.g. 7208; matches broader and narrower codes on the first 8 digits), country (name part, e.g. India), order_number (e.g. 09.9801), celex (exact act, e.g. 32026R1457), history (true also returns rows replaced by later acts; default false keeps the newest act per order), limit (1 to 50, default 20) and cursor (next_cursor, same filters; paging only, not a change checkpoint). Output: quotas[] with order_number, product, CN codes, country, period tonnes, duty and act URL, plus count, has_more, next_cursor and feed freshness (checked twice a day). Not live quota availability. Terms: read-only; MCP calls are never charged. Without a key, metered routes give 10 successful answers a day free, as short samples (up to 3 records, without file proof, history or paging cursor) where a paid HTTP address exists (unmetered routes are unlimited); errors do not count. On the paid HTTP routes, errors are free, and so are empty answers except a sanctions name search with no match when every loaded list it checks is fresh (lists not loaded yet are named in the answer). An optional API key keeps its prepaid-credit policy. When the free answers run out, the error names the HTTP alternative.