BMS Rest APIs V2

Introduction 

BMS has a REST API which is documented using Swagger. On SwaggerUI, you can view all the endpoints and try them. 

Note: The original V1 API documented at https://bms.kaseya.com/api is still available but will no longer receive any enhancements.

The V2 API call limit is 1500 per hour per endpoint.

Resources

Each server has a dedicated swagger interface below are the URLs:

Swagger

Documentation

https://api.bms.kaseya.com/swagger/index.html  https://api.bms.kaseya.com 
https://api.bms.kaseya.com/swagger/index.html  https://api.bmsemea.kaseya.com
https://api.bmsapac.kaseya.com/swagger/index.html  https://api.bmsapac.kaseya.com
https://api.vorexlogin.com/swagger/index.html  https://api.vorexlogin.kaseya.com

Authentication 

  • With SwaggerUI users can authenticate on our API webpage or use any API collaborative platforms like Postman.
  • For valid authentication, a user needs to key in 
    • BMS username and password. 
    • Company name and server URL 
      • Navigate to My Profile: Click on your name on the right of the top navigation bar
        Gateway URL is the server URL of your tenant, eg: https://bmsemea.kaseya.com/ and Company/Tenant name will be listed here.

Authorize your requests

To get started, you will have to authorize your session by clicking the Authorize button and fill the user details in the Authorization modal pictured below:

  1. Navigate to /v2/security/authenticate
  2. Expand, click on Try it out
  3. Fill the form
  4. Fill in the following details, execute.

blobid0.png

  • You will receive a token that can be authorized to make other requests. 
  • The authorize button on the top of the page will use the API key and validate all of the endpoints

mceclip0.png

  • Use refresh token and get a new token without having to refill the form.

blobid1.png

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Contact us