Lookups

Lookups read the law without running an answer. They use a full-text search and call no model. Each needs an API key and counts against the key's lookup rate limit (see Errors and limits). Prices are on Pricing.

SearchCopy Anchor Link

POST /v1/provisions/search

{ "query": "általános forgalmi adó mértéke", "limit": 10 }

The answer is {"object": "list", "data": [...], "usage": {"cost": {...}}}, where each item is a source record without number.

• query is 2 to 500 characters. It is a list of words, and every word must match. A one-word query is valid. A word starting with - is dropped and never searched, and phrases are not searched. A query with no searchable word is 400 invalid_request with param: "query", and is free.
• limit is 1 to 20, and 10 by default.
• X-Jurisdiction works as on responses, with at most 3 countries per call. More is 400 invalid_request with param: "X-Jurisdiction". When none of the named countries can be searched by provision, the call is 400 unsupported_jurisdiction, and is free.
• A search is charged per call.

FetchCopy Anchor Link

POST /v1/provisions/fetch

{ "ids": ["hu:njt:2007-127-00-00:part-3.ch-viii.h1.s142.p1.ptb"], "as_of": "2026-01-01" }

The answer is {"object": "list", "data": [...], "not_found": [...], "usage": {"cost": {...}}}.

• ids is 1 to 20 unit_id values, taken from a source record or a search hit. A unit_id names a provision, not a version, so it keeps working after the law is amended or re-published.
• as_of (YYYY-MM-DD) picks the version in force on that day. Without it, today in UTC. Each record echoes the date it used as as_of.
• Each record is a source record plus text (at most 20,000 characters), truncated (whether the text was cut) and as_of.
• An id that is not found, or that the API does not serve, is listed in not_found and is free. A call that returns no provision is not charged.
• A fetch is charged per provision returned.

SandboxCopy Anchor Link

A sandbox key answers both lookups with sample records. See Keys and sandbox.