> ## Documentation Index
> Fetch the complete documentation index at: https://requestly-mintlify-changelog-requestly-past-week-38456.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Collection Runner

**Collection Runner** enables you to execute multiple saved API requests from a collection in one go, sequentially, while leveraging existing variable and scripting features. Think of it as automating a workflow of requests\
(for example: login → create resource → fetch resource) in one run.

This documentation covers how to run collections, configure variables, view results, rerun or debug, explore automation options, and export results.

### Running a Collection

Follow these steps to run a collection using the Runner:

<Steps>
  <Step title="Open Collection Runner">
    In the Collections sidebar, find the collection you want to execute and click the **Run** icon or menu option next to it.

    <img src="https://mintcdn.com/requestly-mintlify-changelog-requestly-past-week-38456/Mws7Nl41vrG3QlsU/images/collection-runner/304ede81-76f5-4099-a9d1-27f2a746a432.png?fit=max&auto=format&n=Mws7Nl41vrG3QlsU&q=85&s=b9255e4bae96937e4d806b612ac3d439" align="center" fullwidth="false" width="1848" height="1020" data-path="images/collection-runner/304ede81-76f5-4099-a9d1-27f2a746a432.png" />

    *You can also click* ***Runner*** *from collections tab*
  </Step>

  <Step title="Configure Options">
    * **Iterations:** Number of times to execute the full collection

    * **Delay:** Wait time between requests (milliseconds)

    <img src="https://mintcdn.com/requestly-mintlify-changelog-requestly-past-week-38456/Mws7Nl41vrG3QlsU/images/collection-runner/63aa0b0c-72a3-4a5c-b052-eb2efc6e1472.png?fit=max&auto=format&n=Mws7Nl41vrG3QlsU&q=85&s=a0ca9052fe83acfc2a8457c8fc199c08" align="center" fullwidth="false" width="1848" height="1016" data-path="images/collection-runner/63aa0b0c-72a3-4a5c-b052-eb2efc6e1472.png" />

    If you want your collection to run with an environment, select it using the environment selector at the upper left corner, then select the environment you want to use
  </Step>

  <Step title="Adjust Request Order or Skip">
    You can drag to reorder requests or uncheck ones you don’t want to include in this run.

    <img src="https://mintcdn.com/requestly-mintlify-changelog-requestly-past-week-38456/Mws7Nl41vrG3QlsU/images/collection-runner/8652b545-82d1-4243-8a1c-5f77292f2806.gif?s=6a5aa7dbbed82d3e45522a9c28006b31" align="center" fullwidth="false" width="800" height="435" data-path="images/collection-runner/8652b545-82d1-4243-8a1c-5f77292f2806.gif" />
  </Step>

  <Step title="Start the Run">
    Click Save and then Run . The Runner will execute each request in order.

    <img src="https://mintcdn.com/requestly-mintlify-changelog-requestly-past-week-38456/Mws7Nl41vrG3QlsU/images/collection-runner/04897888-950c-4e63-bc87-902aeeec46f9.png?fit=max&auto=format&n=Mws7Nl41vrG3QlsU&q=85&s=e602e848e798a730fa8a66f3deee38e0" align="center" fullwidth="false" width="1848" height="1016" data-path="images/collection-runner/04897888-950c-4e63-bc87-902aeeec46f9.png" />
  </Step>
</Steps>

### How a Collection Runner Works

<img src="https://mintcdn.com/requestly-mintlify-changelog-requestly-past-week-38456/Mws7Nl41vrG3QlsU/images/collection-runner/2cc6558c-8b47-4407-811b-94676c887f91.png?fit=max&auto=format&n=Mws7Nl41vrG3QlsU&q=85&s=8a122ef4f67441ac99f69db7a6ac3cc1" align="center" fullwidth="false" width="1848" height="1016" data-path="images/collection-runner/2cc6558c-8b47-4407-811b-94676c887f91.png" />

When you execute requests using the **Collection Runner**, here’s how things work:

#### Variable Resolution

* All `{{variable}}` placeholders resolve based on their **scope**.

* **Environment variables** override values from the global scope.

* **Collection-level variables** defined earlier are available to all requests within that collection.

#### Script Execution

* **Pre-request** and **Post-response** scripts execute as usual.

* You can **set or modify variables** dynamically during the run.

* Use `rq.expect(...)` for writing **test assertions** to validate responses.

#### Viewing Run Results

<img src="https://mintcdn.com/requestly-mintlify-changelog-requestly-past-week-38456/Mws7Nl41vrG3QlsU/images/collection-runner/6567c990-ab2d-407d-b452-62fa4b2e500d.png?fit=max&auto=format&n=Mws7Nl41vrG3QlsU&q=85&s=5d551061d68a065bec6e688ba0cd716d" align="center" fullwidth="false" width="1848" height="1016" data-path="images/collection-runner/6567c990-ab2d-407d-b452-62fa4b2e500d.png" />

Once the run completes, the Runner displays a detailed **Run Summary**, including:

* Total number of requests executed

* Tests passed and failed

* Total duration and time taken

You can click on any request in the summary to view:

* Request details - URL, headers, and body

* Response data - status, headers, and body

* The result of each test assertion
