Iterating Over Data Files in Tests

Accessing Data Values in Scripts

When a run uses a data file, each iteration's values are available in scripts through pm.iterationData.get("variableName"), letting you reference the current row's data directly.

Tracking Iteration Progress

pm.info.iteration returns the current iteration number, which is useful for logging or for conditionally changing behavior on specific rows.

Validating Per-Iteration Results

TaskHow
Compare expected vs actualRead expected value from data file, compare to response
Skip a row conditionallyUse pm.execution.setNextRequest()
Log iteration detailsconsole.log with pm.info.iteration

Reviewing Results Across Iterations

The Runner summary shows pass/fail results for every iteration separately, making it easy to spot which specific data row caused a failure.

Beyond one-time runs, Postman can also keep testing your API automatically over time - let's look at monitors and alerts.

Ready to master Postman API Testing Course?

Join Uncodemy's hands-on training and build real-world API testing skills with expert mentors.

Explore Course