Docs

Every API here is one HTTPS request that returns JSON. This page is everything that is the same for all of them.

Your key

Get a key from pricing (a monthly plan or a one-off pack). It is shown right after payment, so copy it then. Send it with every call:

curl -H "Authorization: Bearer $API_KEY" "https://tools.funwords.eu/vat/validate?vat=SE556703748501"

X-API-Key: <key> works too. Where a client can only fetch a URL, add api_key=<key> to the query string; a key in a URL can end up in logs, so prefer the header.

Requests

Inputs go in the query string of a GET. A POST with a flat JSON body of the same fields is read as the same call.
Each API's inputs and a sample answer are on its page: PDF to text API, Web page to Markdown API, Company check API, Invoice data extraction API, Document to text API. Every tool has a reference page under /tools.
Add only=key1,key2 to get just those top-level fields of the answer.
sample=1 returns the documented example answer without running anything and without charge.

Sending a file

The PDF reader also takes the file itself, up to 10 MB, as a multipart form field named file or as the raw request body. The file is read in memory for that one request and is not stored.

curl -H "Authorization: Bearer $API_KEY" -F "file=@report.pdf" "https://tools.funwords.eu/pdf/text"

Answers and errors

Status	Meaning	Charged
200	The answer, as JSON.	Yes: the call's price in credits
400, 404, 415, 422	The input was wrong or the thing was not found. The body is JSON with an `error` message that says what to change.	No
402	No key was sent, or the key has too few credits. The body says how to pay.	No
5xx	The service or an outside source it reads could not answer. Safe to try again.	No

A check that could not be made is never reported as a negative result: a VAT number is "not valid" only when the tax authority said so.

Balance, top-ups and a leaked key

Balance: GET https://tools.funwords.eu/credits/balance with your key in the header.
Top up: the balance answer carries links that add credits to the same key.
Replace a key: POST https://tools.funwords.eu/credits/rotate with the key in the header moves the balance to a new key and stops the old one.
Plans: manage or cancel with the e-mail address you paid with.

From an AI assistant

The same tools are an MCP server at https://tools.funwords.eu/mcp; send the key as the Authorization header of the connection. Agents that pay per call without a key: agent catalogue and payment details. Machine-readable: OpenAPI, llms.txt.

Reliability and privacy

Success rates for the last seven days are public at /status. What is and is not stored: privacy.