Frequently asked questions

Answers about getting started, data, billing, and privacy. Can't find what you need? Email support@codepile.dev.

Getting started

How do I get an API key?

Sign up, create an organization, and mint a key from the dashboard — it takes seconds. Send the key as a Bearer token in the Authorization header of each request. See the docs to make your first call.

Do I need a credit card to start?

No. The free tier needs no credit card and lets you start making calls immediately. You only add billing details when you choose to upgrade.

Do I need an SDK?

No. Stawka is a plain REST API with read-only GET endpoints — anything that speaks HTTP works. There’s no SDK to install.

What can the API do?

It returns VAT rates for all 27 EU countries, daily ECB euro reference rates, and real-time VIES VAT-number validation, plus a rate-change log and webhooks. See pricing for the limits on each plan.

Data & accuracy

Where does the data come from?

VAT rates come from the European Commission’s Taxes in Europe Database (TEDB), FX rates from the European Central Bank, and VAT-number checks query the EU’s official VIES service in real time. We normalise these primary sources into one consistent schema.

How current is the data?

Rates are tracked continuously and updated whenever a member state changes one. You can fetch the latest rates, the exact rates in force on any past date, read a change log, or subscribe to a signed webhook that fires the moment a rate moves.

Can I rely on it for tax filings?

The data is provided for information only and is not tax, legal, or accounting advice. We take care to keep it accurate but don’t guarantee completeness or timeliness — you are responsible for verifying it before relying on it. See section 4 of the Terms.

Can I get historical rates?

Yes. Endpoints are date-addressable, so you can fetch the exact VAT rates or FX rates in force on any past date — useful for audits and back-dated invoices.

Billing & plans

How does billing work?

Paid plans are billed in advance — monthly or annually (annual gets 2 months free) — through Stripe. Prices show in your local currency (PLN or EUR). See pricing.

How do I upgrade or downgrade?

Change your plan from the Billing page in your organization’s dashboard. Upgrades take effect within a minute as the API refreshes its cache; to downgrade, manage the subscription in the Customer Portal.

How do I cancel? Are there refunds?

You can cancel any time in the Customer Portal; it takes effect at the end of the current billing period and you keep access until then. Except where the law requires otherwise, fees already paid aren’t refunded for partial periods.

Do prices include VAT?

Prices are shown exclusive of VAT where applicable; VAT is added at the applicable rate at checkout based on your details.

Security & privacy

How are my API keys stored?

Only as irreversible SHA-256 hashes — never in plain text. A key is shown once at creation; after that we can’t recover it, so you rotate or revoke it instead. You can also restrict a key to specific browser origins.

What personal data do you collect?

Your name and email (via Google sign-in), session/technical data, API key metadata, usage logs, and Stripe-handled billing data. Full details are in the Privacy Policy.

Is the Service GDPR-compliant?

Yes. We’re a Poland-based controller and process data under the GDPR, sharing it only with the processors needed to run Stawka (Cloudflare, Stripe, Google). See the Privacy Policy for legal bases, retention, and your rights.

How do I delete my account and data?

Delete your organization and account from the dashboard, or email us at support@codepile.dev. We delete or anonymise your data within a reasonable period, except records we’re legally required to keep (e.g. invoicing).

How do I get support?

Email support@codepile.dev. Paid plans get email and priority support; we aim to respond as quickly as we can.