Interactions API

v1.6 - Request Access

The Interactions API is a RESTful API that allows you to interact with the Dosetta interactions and severity database.

It is used to store and retrieve interactions between two or more medications.

Clinical Details

Data Source

The Interactions API is built on a database of interactions between medications. The data is sourced from the British National Formulary (BNF), Clinical Trials and relevant Summary of Product Characteristics (SPC). Data is updated regularly and logged in a changelog, users by default are not automatically moved to a new version.

Technical Details

Endpoints

The Interactions API has the following endpoint(s):

  • /interactions
  • /interactions/{id}

Usage

Rate limits are 100 requests per hour. If the client exceeds the rate limit, the API will return a 429 Too Many Requests response. Rate limits can be increased by contacting the Dosetta team.

Authentication

The Interactions API is authenticated using JWT to identify the client application. The client must provide a valid access token in the Authorization header.

Error Handling

Standard HTTP status codes and error messages are returned. These are:

  • 400 Bad Request: The request is not valid.
  • 401 Unauthorized: The request is not authorized.
  • 403 Forbidden: The request is forbidden.
  • 404 Not Found: The requested resource was not found.
  • 429 Too Many Requests: The client has exceeded the rate limit.
  • 500 Internal Server Error: The server encountered an error.

Request API Access

To request access to the Interactions API, please fill out the form below: