How do I send my first Cloud Reporting API request?

To try the Bold Reports® REST API, use the interactive API documentation (Try It Now) for each API version.

You need an access token to authenticate requests to the API endpoints.

How to get an access token

In Bold Reports® Cloud, you get a user access token from the Authentication section of the interactive API documentation, and then add it as the Authorization header.

Each user has their own unique token to authenticate requests. This token should be added to the header of the request.

To obtain the User Token, please follow the steps outlined below:

  1. Navigate to the appropriate interactive Rest API documentation link.

  2. Expand the Authentication section and click Try it out.

Try it out button in the Authentication section of the API docs 3. A public demo of the Bold Reports® Server is hosted at adhoc.boldreports.com. To use the public demo, you need to obtain the access token using the sample credentials provided below.

 Username - [email protected]

 grant_type - password

 password - Guest123@BoldReports!

Demo username and password entered in the Authentication request

  1. Click Execute, and then copy the access_token value from the response body. Authentication response body containing the access_token value

  2. Use the access_token as the Authorization header in later API calls.

  3. Click Authorize in the top right corner of the page. Authorize button in the top right corner of the API docs

  4. In the dialog, enter the access token in the Value box in the format ‘Bearer’ + access_token, and then click Authorize.

    Authorize dialog with the Value box for the Bearer token Bearer access token entered in the Authorize dialog Value box

  5. Send requests to the other REST APIs with the parameters described in each API’s documentation.

NOTE: In this interactive document, both API responses and their corresponding code descriptions are provided.

Frequently asked questions

What format does the Authorize value use?

Enter Bearer followed by the access token. The Try It Now console then sends that value as the Authorization header in later requests.

What is the public demo server?

The public demo of the Bold Reports® Server is at adhoc.boldreports.com. You can get a token there with the sample credentials on this page and try API requests.

How do I call the Cloud Reporting REST API from my own code?

Generate a token with the Authentication API, then send it in the Authorization header. See the C# and JavaScript samples in Generate the authentication token using credentials.