> ## Documentation Index
> Fetch the complete documentation index at: https://docs.avicenna.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Query Parameters

Endpoints with configured **query parameters** allow extra information included in requests to be made available in your endpoint flow through variables.

<Frame>
  <img src="https://mintcdn.com/avicenna-a10e7e50/xOt9vhmJdguwuUD-/images/Screenshot2026-02-14at7.18.40PM.png?fit=max&auto=format&n=xOt9vhmJdguwuUD-&q=85&s=530a27a19a52dba229ae22d34c19b2e1" alt="Screenshot2026 02 14at7 18 40PM" width="1129" height="295" data-path="images/Screenshot2026-02-14at7.18.40PM.png" />
</Frame>

Up to 10 query parameters can be configured per endpoint. Parameters are configured in key-value pairs. Here's what an example request containing query parameters would look like:

```shellscript theme={null}
https://example.avicenna.dev/api/my-endpoint?name=Bobby&age=22
```

<Note>
  Query parameters included in a request that are not configured in the endpoint's workshop will be ignored.
</Note>

### Key

The parameter's **key** is its required name that will correspond do the reference variable name. For example, if the key is named "name", the reference variable will be `{params.name}`.

### Default Value

The parameter's **default value** is an optional value that will be used as the its value in the event that a value is not provided in the request.

<Note>
  If a default value is not configured and no value is provided in the request, the parameter's reference variable will return `null`.
</Note>

### Reference Variable

To reference the parameter's value in a request, use its **reference variable** anywhere within the endpoint's flow. The syntax for a query parameter's reference variable will always be `{params.KEY_NAME}` .