The Search API let's you search inside your data.
This page documents the Clinia Search REST API. However, we strongly recomand using our official API clients and librairie to build your search implementation.
The entire API uses JSON encoded as UTF-8.
The body of POST and PUT requests must be either a JSON object or a JSON array (depending on the particular endpoint) and their
Content-Type header should be set to
The body of responses is always a JSON object, and their content type is always
The API uses API Keys to authenticate requests. Authentication is done via HTTP headers:
X-Clinia-Engine-Ididentifies which engine your are accessing.
X-Clinia-API-Keyauthenticates the request
All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.
Clinia uses conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided. Codes in the 5xx range indicate an error with Clinia's servers.
The API uses HTTP status code to indicate if a request succeeded. A 2xx status code indicates success, whereas a 4xx status code indicates failure. When a request fails, the response body will contain a JSON body with additional information of the error.
HTTP Status Code summary
|HTTP Status Code||Description|
|Everything worked as expected|
|The request was unacceptable, often due to missing a required parameter.|
|No valid API key provided.|
|The requested resource doesn't exist.|
|Something went wrong on Clinia's end.|