The Prediction API provides a programmatic way to interact with Analyses you build in Kraken. It is designed to support the integration of Kraken into other applications such as Business Intelligence (BI) platforms, business rules engines, and CRM.

NOTE: When using the Prediction API to generate predictions, the Prediction API input data records should have the same columns (and respective column types) as your training dataset as it exists AFTER any Data Pipeline steps are applied. For example, if your training dataset has a column called "Territory" that you rename to "State" in a Data Pipeline step, your Prediction API input data records should have a column called "State" (NOT "Territory") as Kraken does not apply Data Pipeline steps to your Prediction API input data records.

Version

The current version of the API is 1.0.

Authentication

Authentication is managed using an API key that must be included in the authorization header for every call as a token.

Authorization: token [API key here]

HTTP Return Codes

• 200 will be returned if the call was successful
• 301 will be returned if the URL is incorrect. This is likely if the URL is using http:// and not https://
• 400 if there is an error with the request
• 404 will be returned if the URL is incorrect. This is likely if the URL is using http:// and not https://

Rate Limiting

Currently, there is no rate limit for the API. However, if we find that this is being abused with an extremely excessive amount of API calls, we will block the API key and IP address if necessary.

Base URL

The base URL for all calls is:

https://api.bigsquid.com/predictionapi/

Example:

https://api.bigsquid.com/predictionapi/analyses/12345abc-1ab2-12a1-12ab-1ab234c567d8