Params Tab

The Params tab manages query parameters—the key-value pairs appended to the URL after the ? symbol. These parameters are commonly used for filtering, pagination, sorting, and passing data to GET requests.

What Are Query Parameters?

Query parameters are part of the URL that come after the question mark. They consist of key-value pairs separated by ampersands.

URL Structure

https://api.example.com/users?page=1&limit=10&sort=name
Base URL: https://api.example.com/users
Query string: ?page=1&limit=10&sort=name
Parameters: page=1, limit=10, sort=name

Parameter Table

The Params tab displays a table where each row represents one query parameter.

ColumnDescription
CheckboxEnable or disable the parameter. Disabled parameters are not included in the URL.
KeyThe parameter name (e.g., "page", "limit", "filter").
ValueThe parameter value. Can include environment variables.
Delete (X)Removes the parameter from the list.

Adding Parameters

Method 1: Using the Table

  1. Click "Add Parameter" at the bottom of the table
  2. Enter the key in the Key column
  3. Enter the value in the Value column
  4. The URL updates automatically

Method 2: Typing in the URL

  1. Type or paste parameters directly in the URL input
  2. Use the format: ?key=value&key2=value2
  3. The Params tab automatically syncs with URL changes
Two-way sync: Changes in the Params table update the URL, and changes in the URL update the Params table. They are always in sync.

Enabling and Disabling Parameters

Each parameter has a checkbox that controls whether it is included in the request.

EnabledThe parameter appears in the URL and is sent with the request.
DisabledThe parameter is hidden from the URL but remains in the table. Useful for temporarily removing a parameter without losing its value.

Common Use Cases

Pagination

?page=1&limit=20&offset=0

Control which page of results to retrieve and how many items per page.

Filtering

?status=active&role=admin&created_after=2024-01-01

Narrow down results based on specific criteria.

Sorting

?sort=created_at&order=desc

Define the field and direction for ordering results.

Search

?q=search+term&fields=name,email

Send search queries and specify which fields to search.

API Keys

?api_key={{apiKey}}

Some APIs accept authentication via query parameter. Use environment variables to keep keys secure.

Using Variables in Parameters

Parameter values can include environment variables and random variables.

Example

KeyValue
api_key{{apiKey}}
user_id{{userId}}
timestamp{{random.timestamp}}
request_id{{random.uuid}}

When the request is sent, these variables are replaced with their actual values.

URL Encoding

Tigrister automatically encodes special characters in parameter values to ensure they are transmitted correctly.

CharacterEncoded AsExample
Space%20 or +hello world → hello%20world
&%26A&B → A%26B
=%3Dx=y → x%3Dy
?%3Fwhat? → what%3F
#%23#tag → %23tag
Note: You enter values as plain text—Tigrister handles the encoding automatically when the request is sent.

Params vs Vars

The Params tab is specifically for query parameters (after the ?). For path variables (the :param segments in the URL path), use the Vars tab instead.

Params (Query)
/users?page=1&limit=10
Vars (Path)
/users/:userId/posts/:postId
BodyVars