# 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](/guides/errors#rate-limits)). Prices are on [Pricing](/guides/pricing).

## Search

```http
POST /v1/provisions/search
```

```json
{ "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](/guides/sources) 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.

## Fetch

```http
POST /v1/provisions/fetch
```

```json
{ "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.

## Sandbox

A sandbox key answers both lookups with sample records. See [Keys and sandbox](/guides/keys-and-sandbox).