REST API, Requests, Usage and Throttling

REST API

The Legal Data Hub can be accessed on the high-level API via REST API.

Request

We follow the widely accepted description: "[...] an API call is a request by a software application to access data or any other service from another application or any other server." (see Source).

Based on this, the Legal Data Hub considers every API call as a request. E.g., an execution of a semantic search query via the Semantic Search endpoint is one API call is counted as one request.

API Usage

The API usage is secured by the authorisation and the access token. The access token contains the information which data assets can be accessed.

Throttling

The REST API is throttled to avoid misuse and increase security. If too many requests are sent from one client the API returns a http 429 response. The throttling counter will be reseted after a time period.