# What Can You Do with the ReportingCloud RESTful Service? > ReportingCloud merges MS Word templates with JSON data via the /v1/document/merge endpoint, supporting nested master-detail blocks, merge settings, and output as PDF, DOCX, RTF, or HTML. Additional features include document conversion, page thumbnails, barcode generation, and charts. - **Author:** Bjoern Meyer - **Published:** 2016-08-06 - **Modified:** 2026-07-17 - **Description:** ReportingCloud merges MS Word templates with JSON data via the /v1/document/merge endpoint, supporting nested master-detail blocks, merge settings, and output as PDF, DOCX, RTF, or HTML. Additional features include document conversion, page thumbnails, barcode generation, and charts. - **5 min read** (911 words) - **Tags:** - Cloud - Reporting - ReportingCloud - Web API - **Web URL:** https://www.textcontrol.com/blog/2016/08/06/what-can-you-do-with-the-reportingcloud-restful-service/ - **LLMs URL:** https://www.textcontrol.com/blog/2016/08/06/what-can-you-do-with-the-reportingcloud-restful-service/llms.txt - **LLMs-Full URL:** https://www.textcontrol.com/blog/2016/08/06/what-can-you-do-with-the-reportingcloud-restful-service/llms-full.txt --- The RESTful web service Text Control ReportingCloud is a Web API powered reporting platform that provides the mail merge and reporting functionality of the powerful .NET component TX Text Control. The web service exposes these powerful reporting features using easy-to-use HTTP methods. This article explains the typical scenarios and functions of ReportingCloud. Merging Templates ----------------- [http://api.reporting.cloud/v1/document/merge ](https://docs.reporting.cloud/docs/endpoint/document/merge) The most typical application of ReportingCloud is to merge MS Word compatible templates with JSON data. These templates contain merge fields and repeating blocks that get populated with hierarchical data. ReportingCloud is matching the fields and merge blocks automatically with data from your JSON data in form of arrays. Templates can be uploaded and used from the ReportingCloud template storage and they can be send with the HTTP request including the merge data. Additionally, a variety of settings can be adjusted to control the merge process or to set the document properties: | Key | Value Type | Value Description | |---|---|---| | removeEmptyFields | Boolean | *Optional*. Specifies whether empty fields should be removed from the template or not. The default value is true. | | removeEmptyBlocks | Boolean | *Optional*. Specifies whether the content of empty merge blocks should be removed from the template or not. The default value is true. | | removeEmptyImages | Boolean | *Optional*. Specifies whether images which don't have merge data should be removed from the template or not. The default value is false. | | removeTrailingWhitespace | Boolean | *Optional*. Specifies whether trailing whitespace should be removed before saving a document. The default value is true. | | author | String | *Optional*. Sets the document's author. | | creationDate | DateTime (String) | *Optional*. Sets the document's creation date which will be saved in the document. | | lastModificationDate | DateTime (String) | *Optional*. Sets the date the document is last modified. | | creatorApplication | String | *Optional*. Sets the application, which has created the document. | | documentSubject | String | *Optional*. Sets the document's subject string which will be saved in the document. | | documentTitle | String | *Optional*. Sets the document's title that will be saved in the document. | | userPassword | String | *Optional*. Specifies the password for the user to open the document. | Output formats of resulting documents are DOC, DOCX, RTF, HTML, PDF and PDF/A. Master-detail Nested Blocks --------------------------- A master-detail relationship is a 1:n (one-to-many) type relationship. A typical example for such a relationship is a purchase order and a set of items that belongs to each purchase order. This allows you to create complex nested reports in a very easy way. ReportingCloud's repeating blocks can be nested in unlimited levels. Those nested blocks can be inserted in the same way like usual merge blocks. These blocks can be easily inserted using the HTML5 based online template designer that exposes usable merge blocks automatically based on your data source excerpt fields. Converting Documents -------------------- [http://api.reporting.cloud/v1/document/convert ](https://docs.reporting.cloud/docs/endpoint/document/convert) ReportingCloud can be also used to convert documents from and to industry standard formats including the binary MS Word format DOC, the Office Open XML format DOCX, Adobe PDF and Rich Text Format (RTF) documents. Using a simple HTTP call, source documents can be send to the service in order to retrieve the converted document. Create Images or Thumbnail Images from Documents ------------------------------------------------ [http://api.reporting.cloud/v1/templates/thumbnails ](https://docs.reporting.cloud/docs/endpoint/templates/thumbnails) The Web API also supports rendering document pages to a variety of image formats such as PNG, JPG, BMP and GIF with the highest available accuracy and quality. Besides powerful reporting and conversion processes, the API method */v1/templates/thumbnails* creates and returns images of document pages. It can be used for templates and resulting documents. If a document has been created using */v1/document/merge* or */v1/document/convert*, you can upload the document to your template storage in order to create the images using */v1/templates/thumbnails*. Creating Documents with 1D and 2D Barcodes ------------------------------------------ In today's processes, barcodes are included everywhere: Invoices, delivery notes or boarding passes. Barcodes are used to store digital data on paper that can be acquired easily for further processing using laser-based scanners, cameras or mobile phones. Using ReportingCloud, adding dynamic barcodes is as easy as inserting merge fields into a template. A barcode placeholder will be added to the template and sized to your preferred dimension and location. The barcode object gets a name just like any other merge field. ReportingCloud is encrypting the matching data string from your JSON data in order to render the resulting barcode into your document. All industry format barcode types are supported including QR Code, Maxicode, PDF417, EAN and Postnet. More than 20 formats are supported out-of-the-box. Adding Charts to Your Reports ----------------------------- Powerful data visualizations in a report or any other document are essential to get the "big picture". Charts indicate trends and can be used to attractively visualize large volumes of data. Bars, donuts, pies or financial series - more than 30 fully programmble diagram types can added to the template in the same way like a barcode object. ReportingCloud is filling the chart series automatically with the matching data of your JSON array. These are just some possibilities of the ReportingCloud platform. Whether you need to create invoices, quotes, tickets, stickers, labels or any other dynamic document - ReportingCloud is your Web API powered platform to create those documents for your desktop, web or mobile application. Start today with ReportingCloud and sign up for a [free trial account](https://portal.reporting.cloud/Account/Register/). --- ## About Bjoern Meyer As CEO, Bjoern is the visionary behind our strategic direction and business development, bridging the gap between our customers and engineering teams. His deep passion for coding and web technologies drives the creation of innovative products. If you're at a tech conference, be sure to stop by our booth - you'll most likely meet Bjoern in person. With an advanced graduate degree (Dipl. Inf.) in Computer Science, specializing in AI, from the University of Bremen, Bjoern brings significant expertise to his role. In his spare time, Bjoern enjoys running, paragliding, mountain biking, and playing the piano. - [LinkedIn](https://www.linkedin.com/in/bjoernmeyer/) - [X](https://x.com/txbjoern) - [GitHub](https://github.com/bjoerntx) --- ## Related Posts - [Proofing Tools Available As ReportingCloud Web API Endpoints](https://www.textcontrol.com/blog/2017/08/23/proofing-tools-available-as-reportingcloud-web-api-endpoints/llms.txt) - [All Google Fonts Now Available in ReportingCloud](https://www.textcontrol.com/blog/2017/08/22/all-google-fonts-now-available-in-reportingcloud/llms.txt) - [New ReportingCloud MergeSettings Option: Merge HTML Content into Merge Fields](https://www.textcontrol.com/blog/2017/08/21/new-reportingcloud-mergesettings-option-merge-html-content-into-merge-fields/llms.txt) - [New ReportingCloud Endpoint: List Available Fonts](https://www.textcontrol.com/blog/2017/03/29/new-reportingcloud-endpoint-list-available-fonts/llms.txt) - [Render Document Pages As Images Using the ReportingCloud REST Web API](https://www.textcontrol.com/blog/2016/08/04/render-document-pages-as-images-using-the-reportingcloud-rest-web-api/llms.txt) - [Text Control as a Service: Outsource Your Document Processes](https://www.textcontrol.com/blog/2018/10/08/text-control-as-a-service-outsource-your-document-processes/llms.txt) - [ReportingCloud Monthly Payment Available](https://www.textcontrol.com/blog/2018/09/18/reportingcloud-monthly-payment-available/llms.txt) - [ReportingCloud: Introducing API Keys for Client Authentication](https://www.textcontrol.com/blog/2017/12/29/reportingcloud-introducing-api-keys/llms.txt) - [Sharing Documents with ReportingCloud](https://www.textcontrol.com/blog/2017/10/05/sharing-documents-with-reportingcloud/llms.txt) - [ReportingCloud: Sample Template Gallery Launched](https://www.textcontrol.com/blog/2017/09/03/reportingcloud-sample-template-gallery-launched/llms.txt) - [The End of Monolithic Applications? Outsource Your Document Generation and Reporting Needs with ReportingCloud Microservices](https://www.textcontrol.com/blog/2017/09/01/the-end-of-monolithic-applications-outsource-your-document-generation-and-reporting-needs-with-reportingcloud-microservices/llms.txt) - [ReportingCloud .NET Core Wrapper Released: Creating Documents on Windows, Linux, Mac and Docker](https://www.textcontrol.com/blog/2017/08/28/reportingcloud-net-core-wrapper-released-creating-documents-on-windows-linux-mac-and-docker/llms.txt) - [Retrieving Template Information Using the ReportingCloud Web API](https://www.textcontrol.com/blog/2017/08/11/retrieving-template-information-using-the-reportingcloud-web-api/llms.txt) - [Merging Nested Repeating Blocks in ReportingCloud](https://www.textcontrol.com/blog/2017/08/10/merging-nested-repeating-blocks-in-reportingcloud/llms.txt) - [ReportingCloud: Uploading Templates Vs. Sending Templates Inside MergeBody](https://www.textcontrol.com/blog/2017/08/02/reportingcloud-uploading-templates-vs-sending-templates-inside-mergebody/llms.txt) - [MailMerge: Table Headers and Repeating Blocks](https://www.textcontrol.com/blog/2017/08/01/mailmerge-table-headers-and-repeating-blocks/llms.txt) - [New ASP.NET MVC DocumentViewer Rolled out to the ReportingCloud Portal](https://www.textcontrol.com/blog/2017/04/22/new-aspnet-mvc-documentviewer-rolled-out-to-the-reportingcloud-portal/llms.txt) - [Introducing Groups for ReportingCloud Extreme Users](https://www.textcontrol.com/blog/2017/03/17/introducing-groups-for-reportingcloud-extreme-users/llms.txt) - [Web.TextControl: Adaptive Merge Field Drop-down Lists](https://www.textcontrol.com/blog/2017/02/15/webtextcontrol-adaptive-merge-field-drop-down-lists/llms.txt) - [TX Text Control X14 Service Pack 1 Deployed to ReportingCloud Portal and API](https://www.textcontrol.com/blog/2017/02/07/tx-text-control-x14-service-pack-1-deployed-to-reportingcloud-portal-and-api/llms.txt) - [Printing Labels with MS Word Compatible Templates and Data Sources](https://www.textcontrol.com/blog/2016/12/16/printing-labels-with-ms-word-compatible-templates-and-data-sources/llms.txt) - [ReportingCloud: Conditional Text Blocks Based on Merge Blocks](https://www.textcontrol.com/blog/2016/11/02/reportingcloud-conditional-text-blocks-based-on-merge-blocks/llms.txt) - [Web API Test Sandbox Released on ReportingCloud Portal](https://www.textcontrol.com/blog/2016/10/07/web-api-test-sandbox-released-on-reportingcloud-portal/llms.txt) - [ReportingCloud: New Test Parameter for Document Quota Related Endpoints](https://www.textcontrol.com/blog/2016/10/06/reportingcloud-new-test-parameter-for-document-quota-related-endpoints/llms.txt) - [ReportingCloud: The MergeData JSON Object Format Explained](https://www.textcontrol.com/blog/2016/10/04/reportingcloud-the-mergedata-json-object-format-explained/llms.txt)