We think that people should be empowered to use their data as best as possible and improve their lives. Key to this are open technologies which enable people to access their data freely and put them to good use. With this API we aim to help with that goal, enable people to put their data to new uses, import data from new sources and enrich the Toshl ecosystem.
The purpose of these terms is to ensure fair use and good functioning of the API with a great respect to user’s privacy. We want to enable developers and users to build on top of the Toshl platform, gain additional functionality and work well together with other friendly apps.
We expect you to use the API fairly, not abuse any of the functionality and always respect the privacy and wellbeing of Toshl users.
By registering your app and using the API you are confirming that you have read and accept these API Terms of Use and the general Toshl Terms of Use.
The API is provided as-is, without any guarantees.
We reserve the right to discontinue API access to anyone without prior notice. Following these Terms will generally keep you out of trouble though.
The Toshl services including the API are made and operated by Toshl Inc., 795 Folsom Street, 1st Floor, San Francisco, California 94107, United States.
Do not share the users’ data with third parties.
Make it clear to users what is being done with their data.
You must ensure that any users data is handled in a safe manner.
Gather only the data that is necessary for the functioning of your service.
Have a clear privacy policy, compatible with the principles of the Toshl privacy policy.
You can register your app and get the API keys by visiting the My Apps section. It is your job to keep your API credentials safe. If you think that your keys have been compromised you can revoke them at any time. Currently each application is reviewd by our staf within 2 working days.
When the user wants to connect your app with Toshl and access their data on Toshl, they have to authorise the connection using OAuth 2.0. The connection must be authorised on a web page served from toshl.com using SSL. The user confirms the connection by entering their user credentials and confirming. You are not allowed to alter or modify the display of this page in any way, nor attempt to intercept the user credentials.
We reserve the right to modify the API at any time without prior notice. We will strive to notify you in advance of any major changes and maintain backwards compatibility when that is possible.
You can build a service on top of the Toshl API and charge for it, but you cannot charge for Toshl or Toshl API functionality.
No reverse engineering or copying of the Toshl services.
We will do our best to keep our services bug free and available. If you encounter any problems please notify us. Any problems the users might have due to the use of your app are your responsibility. It is also your responsibility to provide general support to the users of your app.
When importing data to Toshl from an external source, make sure the data will fit within the users system of noting the data. We recommend tagging the imported expenses or incomes with a separate tag to make the identification and managing of the imported data easier. You can also try to extend our API with the extra parameter that is available for most endpoints.
Do not use the Toshl name or approximations in the name of your service. The same rule applies to the use of the Toshl logo. You are encouraged though, to mention “Powered by Toshl” in your services’ description. Do not abuse the Toshl logo and name.
While Toshl strives to have the API available continuously, we cannot guarantee any up-time for the Toshl API.
THE TOSHL SERVICES ARE PROVIDED “AS IS” WITH NO WARRANTY, EXPRESS OR IMPLIED, OF ANY KIND AND WE EXPRESSLY DISCLAIM ANY AND ALL WARRANTIES AND CONDITIONS, INCLUDING ANY IMPLIED WARRANTY OR CONDITION OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AVAILABILITY, SECURITY, TITLE, AND NON-INFRINGEMENT. SOME OF THE TOSHL SERVICES ARE EXPERIMENTAL AND HAVE NOT BEEN TESTED IN ANY MANNER. WE DO NOT REPRESENT, WARRANT OR MAKE ANY CONDITION THAT THE TOSHL SERVICES ARE FREE OF INACCURACIES, ERRORS, BUGS, OR INTERRUPTIONS, OR ARE RELIABLE, ACCURATE, COMPLETE, OR OTHERWISE VALID. YOUR USE OF THE TOSHL SERVICES IS AT YOUR OWN DISCRETION AND RISK, AND YOU WILL BE SOLELY RESPONSIBLE FOR ANY DAMAGE THAT RESULTS FROM USE OF THE TOSHL SERVICES INCLUDING FOR ANY DAMAGE TO YOUR COMPUTER SYSTEM OR LOSS OF DATA. NO ADVICE OR INFORMATION, WHETHER ORAL OR WRITTEN, OBTAINED BY YOU FROM US OR THROUGH OR FROM OUR WEBSITE OR OUR SERVICES WILL CREATE ANY WARRANTY OR CONDITION NOT EXPRESSLY STATED IN THESE TERMS.
YOU AGREE TO THE FOLLOWING LIMITATION OF LIABILITY TO THE EXTENT PERMITTED BY APPLICABLE LAW: YOU EXPRESSLY UNDERSTAND AND AGREE THAT TOSHL WILL NOT BE LIABLE TO YOU FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, OR EXEMPLARY DAMAGES, INCLUDING DAMAGES FOR LOSS OF PROFITS, GOODWILL, USE, DATA, OR OTHER INTANGIBLE LOSSES (EVEN IF TOSHL HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES), RESULTING FROM: (1) THE USE OR THE INABILITY TO USE THE TOSHL SERVICES; (2) THE COST OF PROCUREMENT OF SUBSTITUTE GOODS AND SERVICES; (3) UNAUTHORIZED ACCESS TO OR ALTERATION OF YOUR TRANSMISSIONS OR DATA; (4) STATEMENTS OR CONDUCT OF ANY THIRD PARTY ON OR IN THE TOSHL SERVICES; OR (5) ANY OTHER MATTER RELATING TO THE TOSHL SERVICES. UNDER NO CIRCUMSTANCES WILL TOSHL’S AGGREGATE, CUMULATIVE LIABILITY TO YOU ARISING OUT OF OR IN CONNECTION WITH THESE TERMS, UNDER ANY THEORY OF LIABILITY, EXCEED U.S. ONE HUNDRED DOLLARS (U.S. $100).
You agree to hold harmless and indemnify Toshl Inc., and its affiliates, and their respective directors, officers, agents, employees, advertisers, and partners, from and against any third party claim arising from or in any way related to your use of any Toshl services, violation of these Terms, or any other actions connected with your use of the APIs, including any liability or expense arising from all claims, losses, damages (actual and consequential), suits, judgments, litigation costs and reasonable attorneys’ fees, of every kind and nature.
If you have any doubts or questions regarding the appropriate use of the API, please send us an email to api@toshl.com.