# How to use Query Parameters in Service Suite?

Query parameters are values added to the URL after the `<span class="editor-theme-code">?</span>` character. They are commonly used to provide optional parameters or filters to an API request.

In Service Suite, you can construct a URL dynamically using JavaScript string concatenation and variables.

### Example

The following example uses `<span class="editor-theme-code">$clientNumber</span>` as a query parameter in a GET request. It also adds a timestamp as a cache-busting parameter:

```javascript
var $clientNumber = getLoggedClientNumber(); // Or read the value from a CSV file

var $url = $server + "/common/getClientData/?clientNumber=" + $clientNumber + "&_=" + Date.now();

var $response = get($url);

var $json = JSON.parse($response.getDataString());

var $clientNumber = $json.clientNumber;
```

### How it works

If `<span class="editor-theme-code">$server</span>` contains:

```text
https://example.com
```

and `<span class="editor-theme-code">$clientNumber</span>` contains:

```text
12345
```

the resulting URL will look similar to:

```text
https://example.com/common/getClientData/?clientNumber=12345&_=1750000000000
```

The URL contains two query parameters:

- `<span class="editor-theme-code">clientNumber=12345</span>` — passes the client number to the API.
- `<span class="editor-theme-code">_=</span>` followed by the current epoch time — adds a unique value to help prevent the request from being served from a cached response.

`<span class="editor-theme-code">Date.now()</span>` returns the current time in milliseconds since the Unix epoch.

### Multiple Query Parameters

When an endpoint requires multiple query parameters, use `<span class="editor-theme-code">?</span>` before the first parameter and `<span class="editor-theme-code">&</span>` before each additional parameter.

For example:

```javascript
var $url = $server + "/common/getClientData/?clientNumber=" + $clientNumber + "&status=active";
```

This produces a URL such as:

```text
https://example.com/common/getClientData/?clientNumber=12345&status=active
```

### Query Parameters vs. Path Parameters

A **path parameter** is part of the URL path:

```text
/customer/12345/reports
```

A **query parameter** is included after `<span class="editor-theme-code">?</span>`:

```text
/customer/reports?clientNumber=12345
```

The API determines which format should be used for each endpoint.

### Summary

Use JavaScript string concatenation to dynamically construct URLs containing query parameters:

```javascript
var $url = $server + "/common/getClientData/?clientNumber=" + $clientNumber;
```

When adding more than one query parameter, separate them with `<span class="editor-theme-code">&</span>`:

```javascript
var $url = $server + "/common/getClientData/?clientNumber=" + $clientNumber + "&status=active";
```

---

**Last updated:** August 1, 2026

If you have any feedback on this topic, please contact us at <documentation@appvance.ai>.