In Postman, you can run yourfunctional API tests at any time. Running tests manually enables you to run tests on demand and view the results right away. For example, you can check if an endpoint is working or verify that a code change fixes a specific error.

Running tests manually gives you the flexibility to adjust your test plans based on the changing needs of your project. You can also use manual testing to investigate complex issues and find root causes and possible solutions.

Run a single test

In Postman, the basic unit of testing is anAPI request. Each request tests a specific piece of functionality by calling an API endpoint. You can use scripts to add test logic to a request. For example, you canwrite test scripts to check if the expected data is received when the request is sent.

To manually run a single test, do the following:

1. ClickCollections in the sidebar. Select a collection, then the request with the test you want to run.
2. (Optional) To send the request with anenvironment, select it using the environment selector at the top right of Postman.
3. ClickSend.
4. Click theTest Results tab in the request’s response to view the results.

Learn more atSend a request with the Postman API client.

Run a test suite

UsePostman Collections to organize individual API requests into a test suite. Then use theCollection Runner to run the tests in the order you choose. You can alsoupload data files to run tests multiple times using different data each time.

To manually run a test suite, do the following:

1. ClickCollections in the sidebar, then select the collection or folder you want to run.
2. ClickRun.
3. On theFunctional tab, selectRun manually.
4. (Optional) To run the collection with anenvironment, select it using the environment selector at the top right of Postman.
5. Select your configuration options, such as the number of iterations you want to run.
6. ClickRun Examples. Postman displays the test results in the workbench in real time.

Learn more atTest your API using the Collection Runner.

YourPostman plan gives you a limited number of collection runs you can use each month. Learn more aboutresource usage in Postman.

• On this page

• Run a single test
• Run a test suite