Running a collection

App
The collection runner lets you run collections. Thousands of times if you want.
The collection runner runs requests in a collection in the order in which you se
t them. It also runs tests for every request and gives you an aggregate summary
of what happened. It stores all your test runs so you can compare them and see w
hat has changed.
All you have to do is select a collection, an environment if needed, and hit the
Run button. Optionally, you can also add a CSV or a JSON file from which Postma
n can pick up data values. Need to test all those use cases? It s super easy with
the Collection Runner.
The Collection Runner window runs separately from the main window. While the win
dow is open, you can make changes to your collections inside the main Postman wi
ndow and they will be updated inside the Collection Runner as well.
Starting a run
To start a collection run, you need to set some of these options and hit start.
Only the collection name is compulsory.
Collection/Folder: If a collection has folders, then those requests are executed
as well
Environment (optional)
Iterations (optional): The number of times you want to run the collection. There
is no official limit to the number. At least yet.
Data (optional): Load a CSV/JSON data file
Hit the Start button and Postman will start displaying results of the run. Once
the run is over, you can start a new run or select run statistics from the histo
ry.
Viewing results
Clicking on any run in the sidebar brings up the stats for that run in a new tab
, just in case you want to view a result while a run is ongoing.
Postman displays the parameters you started the run with. It also shows you how
many tests passed among all the tests that were executed. The average response t
ime for the run is also displayed.
You can also see basic stats of all runs of the same type. You can compare how m
any tests passed previously and whether your API code is getting better.
Requests

The Requests tab shows you all the requests which were run in a collection along
with response times, test results and the last received status code. This helps
you quickly get the state of the entire API. If any test fails while running mu
ltiple iterations, the entire test is marked as failed. If everything goes well,
you should expect to see a lot of green. You don t need to have tests in a reques
t to run a collection.
You can get a more detailed per iteration view of the results by clicking the > ar
row when you hover over a request. This shows you a tabulated view of all the te
st iterations. If any test fails, you will see a red dot. You can pinpoint which
iterations failed and which passed through the table.
More options coming soon!