Introduction

Understand general concepts, response codes, and authentication strategies.

Innostocks’s API is currently in alpha.
For questions or feedback, reach out to us at [e-mail].

Base URL

Innostocks’s API is built on REST principles and is served over HTTPS. To ensure data privacy, unencrypted HTTP is not supported.

The Base URL for all API endpoints is:

https://innostocks.com/api/

Authentication

Authentication to the Innostocks API is performed via the Authorization header with a Bearer token. To authenticate, you need to include the Authorization header with the word Bearer followed by your token in your API requests like so:

Authorization: Bearer <token>

You can get your token under your Innostocks Account Settings.

Response Codes

The API returns standard HTTP response codes to indicate the success or failure of an API request. Here are a few examples:

Code	Description
200	The request was successful.
400	The request was invalid or cannot be served.
401	The request requires user authentication.
403	The server understood the request, but refuses to authorize it.
404	The requested resource could not be found.
429	Too many requests.
500	The server encountered an unexpected condition which prevented it from fulfilling the request.

Caveats

• Innostocks’s API is currently in alpha and is subject to change. However, we will do our best to keep breaking changes to a minimum.
• Currently, there’s no versioning system in place. We plan to add versioning in the future.