Before you start.....

NOTE: KLINICLY is an Open Source API that enables innovators and health-tech businesses to easily embed and distribute genuine drugs using our formulary within their products.

Good to know you must have:

• A distributor account with Kinicly

• Get your unique API key from your dashboard.

• And amazing developers on your team.

Get your API keys

Your API requests are authenticated using API keys. Any request that doesn't include an API key will return an error.

You can generate an API key from your Dashboard at any time.

Authentication

The best way to interact with our API is to use one of our official libraries:

Auth

Authentication

# With cURL, you can pass the correct header with each request
curl -L 'https://api.klinicly.net' 
-H 'AccessKey: myapikey'

Good to know: Make sure to replace myapikey with your development or production API key.

Make your first GET request

Alternatively, you can use tokens to get access to the DrugDB APIs. Tokens allow short-term access to Drug API without exposing your secret API key. They are guaranteed to expire within 24 hours. The use of token authentication is required for accessing DrugDB APIs from browser-based applications.

get

Authorizations

Bearer

AuthorizationstringRequired

Input your Bearer token in this format - Bearer {your token here} to access this WebApi

Query parameters

SearchQuerystringOptional

PageNumberinteger · int32Optional

PageSizeinteger · int32Optional

Responses

200

Success

text/plainapplication/jsontext/json

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

text/plainapplication/jsontext/json

500

Server Error

text/plainapplication/jsontext/json

get

/api/v1/Drug

HTTPcURLJavaScriptPython

GET /api/v1/Drug HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

{
  "succeeded": true,
  "message": "text",
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "strenght": "text",
      "brand": "text",
      "company": "text",
      "generic": "text",
      "moa": "text",
      "brandId": "123e4567-e89b-12d3-a456-426614174000"
    }
  ],
  "pageNumber": 1,
  "pageSize": 1,
  "firstPage": "https://example.com",
  "lastPage": "https://example.com",
  "totalPages": 1,
  "totalRecords": 1,
  "nextPage": "https://example.com",
  "previousPage": "https://example.com"
}

Good to know: TOKEN LIFETIME

The default expiry of a token is 24 hours after it was created. The lifetime of a token can be set with the ttl parameter on creation. When set, the ttl is the number of hours the token is valid for, with a maximum of 24 hours. If no unit is given, the ttl is assumed to be in hours. The value can also be sent as a string with a unit attached (“m” for minutes or “h” for hours). A ttl of “15m” will request a token that expires in 15 minutes

Take a look at how you might call this method using our official libraries, or via: curl http://api.klinicly.net/api/v1

Token

{
  "AccessKey": "eyJhbGciOiJIUzI1NiJ9.eyJrZXlfaWQiOjk5MiwiZXhwIjoxNjYxNzg4MzQxfQ.iJ6hDzqBoDs3RMRwv3Ui97qz0Yulyi7IB17g-BgbUlg"
}

Base url