Search provisions

POST
/v1/provisions/search

Search the current provisions of the law in force, with no model call.

The words of query are all required, and one word is enough. A word starting with - is dropped and phrases are not searched. A hit without a unit_id is left out. X-Jurisdiction names at most 3 countries; when none of them can be searched by provision the call is unsupported_jurisdiction, and free.

Charged per call. A sandbox key gets sample records.

Authorization

bearerAuth
headerAuthorizationBearer <token>

Header Parameters

Idempotency-Key?string

Makes a retry safe. A repeat of the same request answers with the stored result and Idempotent-Replayed: true, and is never charged again; the same key on a different request is idempotency_key_reused. Without it, a retry is a new, charged request.

Match^[ -~]+$
Length1 <= length <= 255
X-Jurisdiction?string

The countries whose law is read, comma-separated, in any case and spacing; hu without it. Allowed: at, be, ch, cz, de, dk, es, fi, fr, gb, ge, hr, hu, ie, it, li, lu, mc, nl, no, pl, pt, ro, rs, se, si, sk. Any other code, us, oecd and ifrs included, is unsupported_jurisdiction.

Request Body

application/json
  1. body

POST /v1/provisions/search: AND-ed words, and how many hits to return.

limit?integer

How many hits to return.

Range1 <= value <= 20
Default10
query*string

The words to search for. All are required, and one is enough; a word starting with - is dropped and phrases are not searched.

Length2 <= length <= 500

Response Body

The hits, best first.

application/json
  1. response

The answer to POST /v1/provisions/search.

data*array<>
object*string
usage*

What a provision lookup cost.

Example Request
curl -X POST 'https://api.azta.ai/v1/provisions/search' \  -H 'Content-Type: application/json' \  -d '{  "query": "string"}'
Example Response
{  "data": [    {      "act": {        "identifier": "string",        "short_title": "string",        "title": "string"      },      "country": "string",      "excerpt": "string",      "kind": "provision",      "section": "string",      "title": "string",      "unit_id": "string",      "url": "http://example.com",      "url_kind": "official",      "version": {        "effective_from": "2019-08-24",        "effective_to": "2019-08-24",        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "is_current": true      }    }  ],  "object": "list",  "usage": {    "cost": {      "amount": "string",      "currency": "EUR"    }  }}