VeriActa API
One REST API for the law of every country VeriActa covers. Ask a question or name a provision, and get it quoted in full from the official consolidated text, with its citation, in the wording in force on the date you ask about. Every answer says what it covers. The base URL is https://veriacta.ai/v1; requests and answers are JSON.
Using an AI assistant rather than writing code? Connect it over MCP instead: steps for each assistant.
Quickstart
- Create a free account and an API key on your account page. The key is shown once; the account starts with 200 free credits.
- Put the key in your environment.
- Ask a question.
export VERIACTA_API_KEY="vak_your_key_here"
curl https://veriacta.ai/v1/law/PL/search \
-H "Authorization: Bearer $VERIACTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "sales limit for the VAT small-business exemption", "as_of": "2026-11-14", "limit": 1}'Ask in the country's language or in English; the law's own terms find the provision fastest. limit is the number of hits (1 to 20, 8 by default). The answer, with the text quoted in Polish as the law is written:
{
"jurisdiction": "PL",
"as_of": "2026-11-14",
"results": [
{
"act_id": "DU/2004/535",
"act_short": "ustawa o podatku od towarów i usług",
"path": "art:113/par:1",
"label": "art. 113 ust. 1",
"heading": null,
"ancestors": [
"art. 113"
],
"text": "Zwalnia się od podatku sprzedaż dokonywaną przez podatnika posiadającego siedzibę działalności gospodarczej na terytorium kraju, u którego wartość sprzedaży, z wyłączeniem podatku, nie przekroczyła w poprzednim ani bieżącym roku podatkowym kwoty 240 000 zł.",
"effective_from": "2026-01-01",
"effective_to": null,
"score": 0.9,
"citation": "art. 113 ust. 1 ustawy z dnia 11 marca 2004 r. o podatku od towarów i usług (Dz. U. z 2026 r. poz. 1263)"
}
],
"citation": "art. 113 ust. 1 ustawy z dnia 11 marca 2004 r. o podatku od towarów i usług (Dz. U. z 2026 r. poz. 1263)",
"source": {
"name": "ISAP (Sejm RP)",
"url": "https://isap.sejm.gov.pl/isap.nsf/DocDetails.xsp?id=WDU20040540535",
"snapshot_date": "2026-11-10"
},
"attribution": "Tekst jednolity (Dz. U. z 2026 r. poz. 1263) w brzmieniu ujednoliconym ISAP (Sejm RP), stan na 2026-11-10; ma charakter informacyjny, wiążący jest tekst ogłoszony w dzienniku urzędowym.",
"coverage": {
"status": "covered"
},
"warnings": [],
"usage": {
"credits": 10,
"balance": {
"free_remaining": 190,
"paid_balance": 0,
"unmetered": false
}
}
}The same call from code:
const res = await fetch("https://veriacta.ai/v1/law/PL/search", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.VERIACTA_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({"query": "sales limit for the VAT small-business exemption", "as_of": "2026-11-14", "limit": 1}),
});
const answer = await res.json();
if (!res.ok) throw new Error(`${answer.error.code}: ${answer.error.message}`);
for (const hit of answer.results) console.log(hit.citation, "\n", hit.text);import os, requests
res = requests.post(
"https://veriacta.ai/v1/law/PL/search",
headers={"Authorization": f"Bearer {os.environ['VERIACTA_API_KEY']}"},
json={"query": "sales limit for the VAT small-business exemption", "as_of": "2026-11-14", "limit": 1},
timeout=60,
)
answer = res.json()
if not res.ok:
raise RuntimeError(f"{answer['error']['code']}: {answer['error']['message']}")
for hit in answer["results"]:
print(hit["citation"], "\n", hit["text"])Authentication
Send your key on every request as Authorization: Bearer vak_… or as X-API-Key: vak_…. Keys belong to your account: create, name and revoke them on your account page, where you also see what each call cost.
Call the API from your server, not from a web page: a key in a browser can be read by anyone who opens it. Keep keys in an environment variable or a secret store, never in code you commit.
Endpoints
All paths are under https://veriacta.ai/v1. {jurisdiction} is a country code (PL, ES, DE, …); GET /law/jurisdictions lists those that answer today, and the coverage table shows the rest.
| Endpoint | Credits | What it returns |
|---|---|---|
| GET /law/jurisdictions | 1 | Which countries answer, what each covers and its known gaps. |
| GET /law/{jurisdiction}/resolve | 1 | Find an act by name, acronym, number, ELI or source id (q). |
| GET /law/{jurisdiction}/acts/{act_id} | 1 | An act: its metadata, relations and table of contents. |
| GET /law/{jurisdiction}/acts/{act_id}/provisions/{path} | 2 | One provision as in force on as_of, with its versions and any published later wording. |
| POST /law/{jurisdiction}/search | 10 | The provisions that answer a question, in force on as_of. |
| GET /account | 0 | The account behind the key, its balance and what each call costs. |
| GET /account/usage | 0 | The balance and the latest charges. |
Which countries answer
curl "https://veriacta.ai/v1/law/jurisdictions" \ -H "Authorization: Bearer $VERIACTA_API_KEY"
Find an act
curl "https://veriacta.ai/v1/law/PL/resolve?q=ustawa%20o%20VAT" \ -H "Authorization: Bearer $VERIACTA_API_KEY"
Each result's act_id (for Poland the ELI, DU/2004/535; for Spain the BOE id) is what the act and provision endpoints take, URL-encoded. They also take a name resolve knows.
Read one provision
curl "https://veriacta.ai/v1/law/PL/acts/DU%2F2004%2F535/provisions/art:113/par:1?as_of=2025-12-31" \ -H "Authorization: Bearer $VERIACTA_API_KEY"
{path} is a result's path (art:113/par:1) or the citation as the country writes it (art. 113 ust. 1), URL-encoded.
Your balance
curl "https://veriacta.ai/v1/account" \ -H "Authorization: Bearer $VERIACTA_API_KEY"
The answer
Every law endpoint answers in the same envelope, whatever the country:
| Field | What it is |
|---|---|
| jurisdiction | The country code you asked. |
| as_of | The date the wording is in force on: yours, or today when you sent none. |
| results | Search hits, provisions or acts, depending on the endpoint. A hit has act_id, label (the provision as the law numbers it), path (the same in a form you can pass back to the provisions endpoint), text quoted in full, effective_from / effective_to and its own citation. |
| citation | The citation of the first result, in the country's own format. Show it with the text. |
| source | The official register the text comes from, a link to the act there, and snapshot_date: the day we last read it. |
| attribution | The notice the source's licence asks for, in the source's language. Show it wherever you show the text. |
| coverage | covered, partial or not_covered, with a reason when it is not covered. Check it before you rely on an empty result. |
| warnings | What to tell the reader: PENDING_VERSION (a published amendment will change the wording, detail says when), PROVISION_REPEALED, NOT_IN_FORCE_ON_DATE, CONSOLIDATION_OUTDATED, AS_OF_AFTER_SNAPSHOT, ACT_AMBIGUOUS, NO_MATCH. |
| usage | The credits this call cost and the balance after it; null when nothing was charged. |
Dates and amendments
Send as_of (YYYY-MM-DD) to get the wording in force on that day; without it you get today's. Ask the quickstart's question for 31 December 2025 ("as_of": "2025-12-31") and you get the wording in force then (200 000 zł), valid until the amendment took effect, with a warning that names the day the new wording applies:
{
"as_of": "2025-12-31",
"results": [
{
"label": "art. 113 ust. 1",
"effective_from": "2025-01-01",
"effective_to": "2026-01-01"
}
],
"warnings": [
{
"code": "PENDING_VERSION",
"detail": "art. 113 ust. 1: 2026-01-01"
}
]
}The provision endpoint gives the whole history it can trace: versions lists each wording with the act that introduced it, and pending_versions carries the text of a wording already published but not yet in force.
{
"as_of": "2025-12-31",
"results": [
{
"path": "art:113/par:1",
"effective_from": "2025-01-01",
"effective_to": "2026-01-01",
"versions": [
{
"effective_from": "2025-01-01",
"effective_to": "2026-01-01",
"source_version": "Dz.U. 2024 poz. 1721",
"repealed": false
},
{
"effective_from": "2026-01-01",
"effective_to": null,
"source_version": "Dz.U. 2025 poz. 896",
"repealed": false
}
],
"pending_versions": [
{
"effective_from": "2026-01-01",
"effective_to": null,
"source_version": "Dz.U. 2025 poz. 896",
"repealed": false
}
]
}
],
"warnings": [
{
"code": "PENDING_VERSION",
"detail": "2026-01-01"
}
]
}A date the history does not reach answers 404 HISTORY_NOT_COVERED instead of a wording that might be wrong.
Errors
An error answers with an HTTP status and a body that names it:
{
"error": {
"code": "AUTH_REQUIRED",
"message": "Send an API key, or sign in at /account."
}
}| Status | Code | What happened |
|---|---|---|
| 400 | BAD_REQUEST | A parameter is missing or malformed, e.g. as_of that is not YYYY-MM-DD. |
| 401 | AUTH_REQUIRED | No API key was sent. |
| 401 | INVALID_API_KEY | The key is unknown, mistyped or revoked. |
| 402 | INSUFFICIENT_CREDITS | Not enough credits for this call; nothing was done. plans_url says where to top up. |
| 403 | KEY_NOT_ASSIGNED | The key is not assigned to an account yet. |
| 404 | JURISDICTION_NOT_SUPPORTED | No such country code. GET /law/jurisdictions lists them. |
| 404 | ACT_NOT_FOUND | No act matches; the answer still carries the envelope with coverage.status not_covered. |
| 404 | HISTORY_NOT_COVERED | The wording on that date cannot be traced; the warning names the first date that can. |
503 means a country's collection is being loaded; try again later. Refused calls cost nothing.
Credits
Each call costs the credits in the endpoint table, and only when it answers: an empty result, an error or not_covered is free. Every answer's usage shows what it cost and what is left, and GET /account shows the balance and the price of each call. Your account starts with 200 free credits; after that, top up or choose a monthly plan on the pricing page. When the credits run out a call answers 402 INSUFFICIENT_CREDITS and does nothing.
OpenAPI
The API is described in OpenAPI 3.1 at https://veriacta.ai/v1/openapi.json, which needs no key. Import it into Postman, Insomnia or Bruno, or generate a client from it. Questions or something missing: contact us.
For agents: llms.txt describes VeriActa and how to connect in a form a machine reads, and AI assistants reach the same law over MCP at https://veriacta.ai/mcp.