# postmanlabs/newman

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/postmanlabs-newman).**

7,192 stars · 1,223 forks · JavaScript · apache-2.0

## Links

- GitHub: https://github.com/postmanlabs/newman
- Homepage: https://www.postman.com
- awesome-repositories: https://awesome-repositories.com/repository/postmanlabs-newman.md

## Topics

`api-test` `api-testing` `ci` `jenkins` `json-report` `newman` `postman` `postman-collection`

## Description

Newman is a headless API client and command line tool for executing Postman collections. It serves as an API test automation tool and execution engine that allows users to run predefined sets of API requests without a graphical interface.

The project differentiates itself as a data-driven testing engine, capable of iterating through request sequences using external JSON or CSV files to validate multiple sets of input values. It also functions as an API execution reporter, utilizing a plugin-based interface to output results in formats such as JSON and JUnit.

The tool covers broad capability areas including API regression testing and the integration of automated quality gates within continuous integration pipelines. It provides a variable-injection engine to manage environment and global variables, as well as a configurable network agent to handle SSL settings and proxy routing.

This is a Node.js based execution engine.

## Tags

### Development Tools & Productivity

- [API Request Collections](https://awesome-repositories.com/f/development-tools-productivity/api-development-tools/api-lifecycle-management/api-request-collections.md) — Executes predefined sets of API requests defined in collection files via a command line interface. ([source](https://github.com/postmanlabs/newman/blob/release/5.x/README.md))
- [API Request Executors](https://awesome-repositories.com/f/development-tools-productivity/api-request-executors.md) — Sends requests across multiple protocols with custom authentication and variable data to inspect server responses. ([source](https://www.postman.com/product/))
- [Data-Driven Testing](https://awesome-repositories.com/f/development-tools-productivity/data-driven-testing.md) — Provides a data-driven testing engine that iterates through API requests using external JSON or CSV files. ([source](https://cdn.jsdelivr.net/gh/postmanlabs/newman@develop/README.md))
- [Execution State Exporters](https://awesome-repositories.com/f/development-tools-productivity/environment-variable-exporters/execution-state-exporters.md) — Saves the final state of environment variables, global variables, and cookie jars to files after a run completes. ([source](https://github.com/postmanlabs/newman/blob/release/5.x/README.md))
- [Event Listeners](https://awesome-repositories.com/f/development-tools-productivity/event-listeners.md) — Provides hooks to trigger custom logic at specific lifecycle stages, such as before a request or after a run. ([source](https://cdn.jsdelivr.net/gh/postmanlabs/newman@develop/README.md))
- [Headless Execution Environments](https://awesome-repositories.com/f/development-tools-productivity/headless-execution-environments.md) — Executes API tests in a headless mode within containers to ensure isolated and consistent runtimes.
- [Request Execution Settings](https://awesome-repositories.com/f/development-tools-productivity/request-execution-settings.md) — Sets timeouts, delays, and SSL verification toggles to manage request behavior during test runs. ([source](https://cdn.jsdelivr.net/gh/postmanlabs/newman@develop/README.md))

### DevOps & Infrastructure

- [Test Execution Automation](https://awesome-repositories.com/f/devops-infrastructure/api-service-management/api-management/api-operations-automation/test-execution-automation.md) — Provides a command line interface for running predefined sets of API requests to verify system behavior.
- [CI/CD Pipeline Integrations](https://awesome-repositories.com/f/devops-infrastructure/ci-cd-pipeline-integrations.md) — Integrates automated API tests into commit pipelines to act as quality gates against regressions and schema drift.
- [Environment Variable Management](https://awesome-repositories.com/f/devops-infrastructure/configuration-management/environment-management/environment-variable-management.md) — Loads specific variable sets from files or URLs to customize request data at runtime. ([source](https://cdn.jsdelivr.net/gh/postmanlabs/newman@develop/README.md))
- [Environment Variable Configurations](https://awesome-repositories.com/f/devops-infrastructure/configuration-management/environment-management/environment-variable-management/environment-variable-configurations.md) — Injects runtime settings and configuration parameters into requests via environment and global variable stores. ([source](https://github.com/postmanlabs/newman/blob/release/5.x/README.md))
- [Quality Gates](https://awesome-repositories.com/f/devops-infrastructure/continuous-integration/quality-gates.md) — Integrates automated testing and protocol verification into commit pipelines to block builds containing regressions. ([source](https://www.postman.com/postman-enterprise/))
- [Execution Flow Controls](https://awesome-repositories.com/f/devops-infrastructure/automation-orchestration/task-execution-frameworks/execution-flow-controls.md) — Manages the run process by selecting folders, setting timeouts, or stopping execution upon the first failure. ([source](https://github.com/postmanlabs/newman/blob/release/5.x/README.md))
- [Automated Testing Containers](https://awesome-repositories.com/f/devops-infrastructure/container-orchestration/container-runtimes/runtime-configuration-interfaces/docker-socket-orchestrators/docker-target-configurators/docker-container-deployments/docker-container-execution/automated-testing-containers.md) — Provides the ability to run API test suites within isolated containers to ensure environment consistency. ([source](https://learning.postman.com/docs/postman/collection-runs/newman-with-docker/))

### Testing & Quality Assurance

- [API Collection Runners](https://awesome-repositories.com/f/testing-quality-assurance/api-collection-runners.md) — Provides a headless command line tool to execute predefined sets of API requests defined in Postman collection files.
- [API Testing](https://awesome-repositories.com/f/testing-quality-assurance/api-network-testing/api-testing.md) — Runs automated test suites and regression checks through command line interfaces or CI pipelines. ([source](https://www.postman.com/product/))
- [Automated Testing Tools](https://awesome-repositories.com/f/testing-quality-assurance/automated-testing-tools.md) — Serves as a comprehensive tool for running automated regression checks and quality gates in CI pipelines.
- [Data-Driven Testing](https://awesome-repositories.com/f/testing-quality-assurance/data-driven-testing.md) — Repeats request sequences by mapping rows from CSV or JSON files to request variables for each iteration.
- [External Result Reporters](https://awesome-repositories.com/f/testing-quality-assurance/general-testing-utilities/test-reporters/external-result-reporters.md) — Utilizes a plugin-based interface to output execution results to various internal and external report formats. ([source](https://cdn.jsdelivr.net/gh/postmanlabs/newman@develop/README.md))
- [Test Result Reporters](https://awesome-repositories.com/f/testing-quality-assurance/general-testing-utilities/test-reporters/test-result-reporters.md) — Outputs API test results into multiple structured formats such as JSON and JUnit.
- [API Request Clients](https://awesome-repositories.com/f/testing-quality-assurance/http-request-clients/api-request-clients.md) — Provides a headless Node.js execution engine for sending network requests and verifying responses without a GUI.
- [Regression Testing Suites](https://awesome-repositories.com/f/testing-quality-assurance/regression-testing-suites.md) — Executes saved request collections across different environments to verify that new changes do not break existing functionality.
- [Request Sequence Definitions](https://awesome-repositories.com/f/testing-quality-assurance/request-sequence-definitions.md) — Executes network calls by iterating through a structured JSON schema that defines the order and parameters of requests.
- [Test Execution Reports](https://awesome-repositories.com/f/testing-quality-assurance/test-execution-reports.md) — Generates test results in multiple formats including CLI, JSON, and JUnit for detailed analysis. ([source](https://github.com/postmanlabs/newman/blob/release/5.x/README.md))

### Data & Databases

- [Session Variable Stores](https://awesome-repositories.com/f/data-databases/key-value-stores/session-variable-stores.md) — Maintains a mutable key-value store of cookies and environment variables that persists across the execution lifecycle.

### Web Development

- [Variable Injection](https://awesome-repositories.com/f/web-development/request-body-handling/variable-injection.md) — Replaces placeholders in request templates with values from environment or global stores during runtime.
- [Execution Lifecycle Hooks](https://awesome-repositories.com/f/web-development/event-listeners/execution-lifecycle-hooks.md) — Triggers custom callbacks at specific stages of the execution lifecycle, such as before a request. ([source](https://github.com/postmanlabs/newman/wiki/Newman-Run-Events))

### Networking & Communication

- [Network Agent Configuration](https://awesome-repositories.com/f/networking-communication/network-infrastructure-routing/network-infrastructure-configuration/network-configuration/network-agent-configuration.md) — Provides customization of low-level networking behavior, including SSL settings and proxy routing, via a configurable network agent.
- [Network Proxy Configurations](https://awesome-repositories.com/f/networking-communication/network-infrastructure-routing/network-infrastructure-configuration/network-configuration/network-proxy-configurations.md) — Supports routing traffic through HTTP, HTTPS, or SOCKS proxies via environment variables or custom agents. ([source](https://cdn.jsdelivr.net/gh/postmanlabs/newman@develop/README.md))

### Security & Cryptography

- [Certificate Handling](https://awesome-repositories.com/f/security-cryptography/certificate-handling.md) — Manages SSL certificates and allows disabling verification for self-signed certificates in restricted environments. ([source](https://github.com/postmanlabs/newman/blob/release/5.x/README.md))

### Software Engineering & Architecture

- [API Workflow Automation](https://awesome-repositories.com/f/software-engineering-architecture/api-workflow-automation.md) — Automates sequential API interactions where the output of one call serves as the input for another. ([source](https://www.postman.com/templates/))
- [Reporting Plugins](https://awesome-repositories.com/f/software-engineering-architecture/software-architecture/architectural-patterns/plugin-module-systems/modular-plugin-architectures/plugin-based-architectures/reporting-plugins.md) — Outputs execution results into formats like JSON or JUnit through an extensible reporting plugin interface.