> For the complete documentation index, see [llms.txt](https://docs.silverband.com.au/home/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.silverband.com.au/home/paradigm-knowledge-base/generating-reports/workflows/advanced-report-builder/add-api-parameters.md).

# Add API Parameters

The purpose of this documentation is to provide a reference for calling Report Builder reports via the API.

The parameters used in the API URL are specified in the Report Builder in the FILTER CLAUSES section, under the **Form Editor** tab. You can refer to the instructions below:

1. Load the Saved Report in Report Builder, *see* [Edit a Saved Report](/home/paradigm-knowledge-base/generating-reports/workflows/introduction-to-report-builder/edit-a-saved-report.md)
2. Once the Saved Report is loaded, navigate to the FILTER CLAUSES section and open the **Form Editor** tab.

{% hint style="info" %}
**NOTE**:

The fields that will appear on this tab are the fields that you have added under the **Set Filter Clauses** tab, *see* [Step 4 - Add Filter Clauses](/home/paradigm-knowledge-base/generating-reports/workflows/build-a-report/step-4-add-filter-clauses.md) workflow when building a report using Report Builder. This tab is also used to set up the report for users to dynamically enter filter values when run under the **Reports** menu, *see* [Form Label | Appear on Form Section](/home/paradigm-knowledge-base/generating-reports/workflows/introduction-to-report-builder/form-label-or-appear-on-form-section.md)
{% endhint %}

<figure><img src="https://1246578764-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC21t2SaV2eKaLxvtR27D%2Fuploads%2FXtjnZCNYggWRjk8PhoHD%2Fimage.png?alt=media&amp;token=845024bb-c7ce-4190-9b86-c345a2e6c359" alt=""><figcaption><p>Saved Report <strong>Form Editor</strong> tab under the FILTER CLAUSES section</p></figcaption></figure>

The label on the form (**Label on form** *column in the above screenshot*) is used to determine the parameter in the API URL. It is important to note that the label on the form should not contain any spaces in order to work correctly. The API will attempt to replace any spaces with underscores. For example, if the label on the form is "**Unit Enrolment Status**", the corresponding argument in the URL will be "**Unit\_Enrolment\_Status**".

## Example

GET argument format:

```
...{{reportID}}?{{argument name}}={{value}}&{{argument name}}={{value}}&{{argument name}}={{value}}
```

Saved Report **Form Editor** parameters in Paradigm:

<figure><img src="https://1246578764-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FC21t2SaV2eKaLxvtR27D%2Fuploads%2FSWHCBpxgffkjzdZRrpZE%2Fimage.png?alt=media&amp;token=9450fcea-b3f7-4cd8-81cf-b6aed268ee0e" alt=""><figcaption></figcaption></figure>

with the parameters specified in the Saved Report:

```
...?PersonStatus=PERSON_ACTIVE&EnrolmentStatus=ENROLMENT_ENROLLED&createdAfter=2023-01-20
```

The {{argument name}} have now been replaced with the **Label on form** field in the Saved Report's **Form Edition** tab. As for the {{value}}, set them accordingly.