# ReportingCloud

> A hosted Web API that merges MS Word compatible templates with JSON data into PDF, DOCX and other documents, with a portal, a template editor and SDKs.

- **Product:** ReportingCloud
- **Kind:** Topic
- **Path:** ReportingCloud
- **1292 words**
- **Web URL:** https://docs.textcontrol.com/reporting-cloud/
- **LLMs URL:** https://docs.textcontrol.com/reporting-cloud/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/reporting-cloud/llms-full.txt

---

ReportingCloud is a document generation service that Text Control hosts for you. Your application sends a template with merge fields and merge blocks, or the name of a template it stored in ReportingCloud before, together with JSON data to the Web API at `https://api.reporting.cloud/`, and ReportingCloud returns the merged documents as PDF, DOCX, DOC, RTF, HTML or another format. Any language that can send an HTTPS request with JSON can use it, and SDKs for .NET, PHP, Java and Ruby wrap the requests in classes.

That is what separates ReportingCloud from the other Text Control products. TX Text Control .NET Server is a set of components you compile into a .NET application, and DS Server is a document server you run on your own infrastructure. ReportingCloud runs on Text Control's servers: there is nothing to install, you sign up for an account, create an API key and send requests. You design templates in Microsoft Word or in the template editor of the ReportingCloud portal.

### What You Can Build

| Task | Read |
|---|---|
| Merge a template with JSON data to create invoices, quotes, contracts and reports | [Mail Merge](https://docs.textcontrol.com/reporting-cloud/mail-merge/llms-full.txt) |
| Repeat table rows for line items, nest them and show sections only when data exists | [Merge Blocks](https://docs.textcontrol.com/reporting-cloud/mail-merge/blocks/llms-full.txt), [Conditional Blocks](https://docs.textcontrol.com/reporting-cloud/mail-merge/conditional-content/llms-full.txt) |
| Convert documents between DOCX, DOC, RTF, HTML, PDF and other formats | [Converting Documents](https://docs.textcontrol.com/reporting-cloud/document-processing/converting/llms-full.txt) |
| Combine documents, replace text in them or render their pages as images | [Appending Documents](https://docs.textcontrol.com/reporting-cloud/document-processing/appending/llms-full.txt), [Find and Replace](https://docs.textcontrol.com/reporting-cloud/document-processing/find-replace/llms-full.txt), [Thumbnails](https://docs.textcontrol.com/reporting-cloud/document-processing/thumbnails/llms-full.txt) |
| Store templates in ReportingCloud and design them in the browser | [Portal](https://docs.textcontrol.com/reporting-cloud/portal/llms-full.txt) |
| Check the spelling of text | [Spell Checking](https://docs.textcontrol.com/reporting-cloud/document-processing/spell-checking/llms-full.txt) |

### Who This Documentation Is for

It is written for developers who add document generation to an application, and it does not assume that you know anything about Text Control.

- **Calling the Web API**: you need to know how to send an HTTP request and handle JSON. The language does not matter. Start at [Web API](https://docs.textcontrol.com/reporting-cloud/getting-started/web-api/llms-full.txt).
- **Working in .NET, PHP, Java or Ruby**: the SDKs turn the requests into method calls. Start at [.NET](https://docs.textcontrol.com/reporting-cloud/getting-started/dotnet/llms-full.txt), [PHP](https://docs.textcontrol.com/reporting-cloud/getting-started/php/llms-full.txt), [Java](https://docs.textcontrol.com/reporting-cloud/getting-started/java/llms-full.txt) or [Ruby](https://docs.textcontrol.com/reporting-cloud/getting-started/ruby/llms-full.txt).
- **Designing templates**: start at [Template Design](https://docs.textcontrol.com/reporting-cloud/mail-merge/template-design/llms-full.txt) and the [Template Editor](https://docs.textcontrol.com/reporting-cloud/portal/template-editor/llms-full.txt) of the portal.

### How This Documentation Is Organized

The navigation on the left follows the order you meet the service in.

- **[Overview](https://docs.textcontrol.com/reporting-cloud/overview/llms-full.txt)** explains what ReportingCloud consists of, how it compares with DS Server and TX Text Control .NET Server, how the service is built, which file formats it reads and writes, what the plans include and how it handles your data.
- **[Installation Guide](https://docs.textcontrol.com/reporting-cloud/installation/llms-full.txt)** sets up what a client needs, as there is no server to install: an account, an API key and, if you want one, an SDK. It also lists the requirements of each SDK and covers upgrading to a subscription.
- **[Getting Started](https://docs.textcontrol.com/reporting-cloud/getting-started/llms-full.txt)** creates a first document with curl, with the .NET SDK in an ASP.NET Core or ASP.NET MVC 5 application, or with the PHP, Java or Ruby SDK.
- **[Portal](https://docs.textcontrol.com/reporting-cloud/portal/llms-full.txt)** covers the ReportingCloud portal: the dashboard, the template storage, the template editor, datasource excerpts, your account, transactions and statistics.
- **[Mail Merge](https://docs.textcontrol.com/reporting-cloud/mail-merge/llms-full.txt)** shows how templates and JSON data become documents: merge data, merge fields, merge blocks and nested blocks, images, conditional blocks, HTML content, merge settings, culture and template design.
- **[Document Processing](https://docs.textcontrol.com/reporting-cloud/document-processing/llms-full.txt)** shows the other tasks of the Web API: authentication, converting, appending, find and replace, thumbnails, template storage, sharing, spell checking, tracked changes and errors.
- **[SDKs](https://docs.textcontrol.com/reporting-cloud/sdks/llms-full.txt)** compares the .NET, PHP, Java and Ruby SDKs and describes the methods of each.
- **[Troubleshooting](https://docs.textcontrol.com/reporting-cloud/troubleshooting/llms-full.txt)** starts from what you see, such as a 500, 403 or 400 response, a used-up quota or a merged document that looks wrong, and leads to the cause and the fix.
- **[What's New](https://docs.textcontrol.com/reporting-cloud/whats-new/llms-full.txt)** lists the changes to the service and its SDKs by year since the release in 2016.
- **[API Reference](https://docs.textcontrol.com/reporting-cloud/reference/llms-full.txt)** documents every endpoint of the Web API with its parameters, payloads and responses, and points to the API documentation of the SDKs.

### Where to Start

1. [Introduction](https://docs.textcontrol.com/reporting-cloud/overview/introduction/llms-full.txt): what ReportingCloud is and what it consists of.
2. [Creating an Account](https://docs.textcontrol.com/reporting-cloud/installation/account/llms-full.txt) and [API Keys](https://docs.textcontrol.com/reporting-cloud/installation/api-keys/llms-full.txt): a trial account, free for 30 days, and the key your requests authenticate with.
3. [Web API](https://docs.textcontrol.com/reporting-cloud/getting-started/web-api/llms-full.txt): merge the demo template of your account with JSON data and save the PDF.
4. [Mail Merge](https://docs.textcontrol.com/reporting-cloud/mail-merge/llms-full.txt): build templates and data for your own documents.

### Getting Help

- **Something does not work.** [Troubleshooting](https://docs.textcontrol.com/reporting-cloud/troubleshooting/llms-full.txt) collects the common problems with credentials, quotas and merge results, and [Getting Support](https://docs.textcontrol.com/reporting-cloud/troubleshooting/support/llms-full.txt) lists the ways to reach Text Control.
- **The service seems down.** The status page at [status.reporting.cloud](https://status.reporting.cloud) shows the availability of the Web API, the portal and the backend.
- **You have a question about plans or prices.** See [Plans and Licensing](https://docs.textcontrol.com/reporting-cloud/overview/licensing/llms-full.txt) or [contact the Text Control sales team](https://www.textcontrol.com/contact/).

---

## In This Section

- [Document Processing](https://docs.textcontrol.com/reporting-cloud/document-processing/llms-full.txt): Process documents beyond mail merge: convert, append, replace text, render thumbnails, manage and share templates, check spelling and review tracked changes.
- [Getting Started](https://docs.textcontrol.com/reporting-cloud/getting-started/llms-full.txt): Create a first ReportingCloud document: merge a template to PDF with curl, with the .NET SDK in ASP.NET Core or MVC 5, or with the PHP, Java or Ruby SDK.
- [Installation Guide](https://docs.textcontrol.com/reporting-cloud/installation/llms-full.txt): Set up ReportingCloud without installing a server: create a trial account and an API key, add the .NET, PHP, Java or Ruby SDK and buy a subscription.
- [Mail Merge](https://docs.textcontrol.com/reporting-cloud/mail-merge/llms-full.txt): Turn templates and JSON data into PDF or DOCX with the document/merge Web API: merge fields, blocks, images, HTML, culture, settings and the template editor.
- [Overview](https://docs.textcontrol.com/reporting-cloud/overview/llms-full.txt): Evaluate ReportingCloud before you sign up: its parts and architecture, file formats per endpoint, plans and quotas, data security and the GDPR.
- [Portal](https://docs.textcontrol.com/reporting-cloud/portal/llms-full.txt): Log in to the ReportingCloud portal, read the dashboard's service status and quota tiles and find templates, excerpts, API keys and statistics in its menu.
- [API Reference](https://docs.textcontrol.com/reporting-cloud/reference/llms-full.txt): Look up the ReportingCloud Web API endpoints for merging, converting, templates, API keys, fonts and proofing, and the SDK docs for .NET, PHP, Java and Ruby.
- [SDKs](https://docs.textcontrol.com/reporting-cloud/sdks/llms-full.txt): Compare the ReportingCloud SDKs for .NET, PHP, Java and Ruby: packages, runtime requirements, authentication, endpoints they lack and how current each one is.
- [Troubleshooting](https://docs.textcontrol.com/reporting-cloud/troubleshooting/llms-full.txt): Trace a failing ReportingCloud request from its status code: 500 without credentials, 403 for refused keys or quotas, 400 Bad Request or a wrong merge result.
- [What's New](https://docs.textcontrol.com/reporting-cloud/whats-new/llms-full.txt): ReportingCloud changes by year: SDK releases from 2020 to 2024, older versions from 2016 with the Web API endpoints, breaking changes and deprecated APIs.

---

## Nearby

- **Next:** [Overview](https://docs.textcontrol.com/reporting-cloud/overview/llms-full.txt)
