Aurelmark API

One endpoint returns the current submission deadlines for a tender and every change recorded since you last asked.

Overview

All requests go to https://aurelmark.ishanpatel.workers.dev over HTTPS and return JSON. A tender is identified by the TED publication number of the first notice in its procedure, for example 662865-2026. Only enrolled tenders are tracked; /v1/coverage lists them, and anyone can request one.

Authentication

Send your API key as a bearer token. Keys look like am_1a2b3c4d_…. Keep them secret: requests made with your key use your credits.

Authorization: Bearer $AURELMARK_KEY

Don't have a key yet? Request a free trial key with 100 requests.

No key at all

You can call the changes endpoint without any key. Each caller gets 100 successful responses a day for free, reset at midnight UTC, and every response says how many are left in X-Free-Requests-Remaining. Errors never count. After that, the API answers 402 free_tier_exhausted until the next day, or you can use an API key.

Get changes

$ curl -H "Authorization: Bearer $AURELMARK_KEY" \
    https://aurelmark.ishanpatel.workers.dev/v1/procurement/eu/notices/662865-2026/changes

Response

A successful response has status 200 and an X-Credits-Remaining header.

Each change event

Errors

Errors return JSON with an error code. Only a 200 uses a credit.

Request a tender

Coverage grows on request. Email ishanpatel3416@gmail.com with the TED publication number of the first notice in the procedure, for example 662865-2026. We add it within one working day, usually the same day, as long as TED publishes it as a standard eForms contract notice with lot deadlines. If we can't, we reply and say why.

Until a tender is added, the changes endpoint answers 404 with notice_not_tracked. That means "not watched yet", not an error in the request. Once added, the tender appears in /v1/coverage. Its first check is the baseline, and every deadline change after that is recorded.

API stability

Everything under /v1, as described in /openapi.json, is a stable contract. Changes there are only additive: new optional fields or new endpoints. We don't rename or remove a path, parameter, response field or error code. A breaking change would ship only under /v2, with at least 90 days' notice by email to everyone integrating with us, and /v1 keeps working throughout.

Polling

Deadlines are checked once an hour, so polling each tender hourly is plenty.

• Make the first call without a cursor and store checkpoint_cursor.
• Next time, send ?cursor= with the stored value. You receive only changes recorded since then.
• If next_cursor is set, request it straight away to fetch the next page.
• Cursors last 24 hours. After a 410, call without a cursor and compare current_deadlines with what you have.

Billing

Buy credits at pricing. Checkout is run by Dodo Payments, our merchant of record, and your API key arrives by email straight after payment. Use it exactly like any other key; the first request activates it and loads your credits.

With a key, each 200 response uses one credit; HEAD requests and every error are free. Without a key, the first 100 successful responses each day are free. Credits are prepaid at $0.02 each, $10 for 500, and never expire. See pricing and our refund policy.

CBAM lookup

Free, with no key. It gives the official CBAM default emissions for a good and country, the mark-up for the year, and the latest CBAM certificate price. Every response names the regulation and the Commission page each number comes from.

$ curl "https://aurelmark.ishanpatel.workers.dev/v1/cbam/default-values?cn=7208&country=IN&year=2027"

Each match has default_value (direct, indirect and total, in tCO2e per tonne of good), markup_percent, total_with_markup, the production_route for the CBAM benchmark, and gross_cost_eur_per_tonne. That cost is before the free allocation adjustment and any carbon price paid abroad, so the real bill is usually lower. The binding figure with the mark-up is calculated in the EU's CBAM Registry.

Also free: /v1/cbam/certificate-price for the published certificate prices, and /v1/cbam/countries for the countries in the regulation.

EUDR scope check

Free, with no key. Is a CN code covered by the EU Deforestation Regulation? The answer comes from Annex I of Regulation (EU) 2023/1115 as amended by 2025/2650.

verdict is yes, partly (an "ex" line: only the goods described are covered), some_codes_below (enter a longer code) or no. Each answer lists the matching Annex I lines, the dates it applies from, and the official sources. /v1/eudr/products returns the whole list. There is also a web page.

EU deadlines

Free, with no key. These are the dates when EU rules start to apply: EUDR, CBAM, the AI Act, CSRD, CSDDD, the Cyber Resilience Act and more. Each one shows the date in force today, every earlier date it had, and the Official Journal act and word-for-word quote behind each date.

$ curl "https://aurelmark.ishanpatel.workers.dev/v1/eu/deadlines?law=EUDR"

Each deadline has date, days_until, times_moved, previous_date, source and history. Every source carries the act, the article, the quote, the official url and the sha256 of the exact file we read. One deadline is at /v1/eu/deadlines/{id}, for example eudr-large-medium-operators. This is information, not legal advice.

MCP server

Agents that speak the Model Context Protocol can use every tool above directly. https://aurelmark.ishanpatel.workers.dev/mcp is a remote MCP server (Streamable HTTP) with nine read-only tools: the watched tenders, tender deadline changes, CBAM default values, certificate price and countries, EU deadlines and the EUDR scope check. It is listed in the official MCP Registry as io.github.Ishan73744/aurelmark. The same free tier applies. For prepaid credits, add your key as an Authorization header.

{ "mcpServers": { "aurelmark": { "type": "http", "url": "https://aurelmark.ishanpatel.workers.dev/mcp" } } }

$ claude mcp add --transport http aurelmark https://aurelmark.ishanpatel.workers.dev/mcp

Free endpoints

Questions or a tender to add? Email ishanpatel3416@gmail.com.