Use the Collection Runner from the Postman VS Code extension

With the Postman VS Code extension, you can use the Collection Runner to manually run a collection's or folder's requests in a specific sequence. This enables you to test an API's functionality or performance. You can also automate collection runs in your CI/CD with the Postman CLI or Newman.

To learn more about manual collection runs in Postman, see Test your API using the Collection Runner.

Configure a collection run

To manually run requests in a collection or folder, do the following:

  1. Select a collection or folder with requests you want to run in sequence.
  2. Click Run icon Run to configure the collection run.
  3. To run your collection with an environment, select it using the environment selector at the upper right. You can also click Create New to create a new environment. Learn how to manage environments in the VS Code extension.
  4. Choose any configuration options. For more information each option, see Configure a collection run.
  5. To run the collection with your completed configuration, click Run (collection name).

Your Postman plan gives you a limited number of collection runs you can use each month. This limit applies to collections you run manually. A collection run with multiple iterations counts as a single run.

Debug run results

When running collections manually, Postman displays the results of your request runs and test results in real time. To learn more about what happened during the collection run, you can:

  • Select a request to view more details about it, including the response, headers, and request.
  • Click the name of a request to open it in a new tab.
  • Click the Passed, Failed, or Skipped tabs to filter the results by test status. To show all requests, click the All Tests tab. If any tests in a request script fail during a collection run, the whole request fails.
  • Click View all runs to view the run history for your collection.
  • Click Run icon Run Again to run the collection again using the same settings.
  • Click Add icon New Run to configure a new run for the collection. Make changes to any settings, and then select Run (collection name) to run the collection again.

Learn more about debugging run results in Postman.

View run history

You can view the run history for your collection, including collections you ran, using the Collection Runner and the Postman CLI.

Select a collection or folder, then select the Runs tab. You can filter your run history by the number of collection runs to view, by users, the test status of the collection runs, and the source of the collection run.

To return to the results of the collection run, hover over a collection run and click Report icon View Report.

Learn more about viewing run history in Postman.

Last modified: 2025/08/22