Overview
Newman is a command-line runner for Postman Collections. Requests, test scripts, environment variables, and iteration data authored in Postman can be executed without the GUI in local scripts and CI/CD pipelines, with JSON and JUnit reporting available.
Features and best fit
Based on official documentation; not hands-on tested · Content checked:
Run Postman Collections directly from the command line
Exported Collection JSON or a collection URL can be passed to newman run, with environment and global variables supported.
Sources: [2]
Use iteration data and reporters for CI workflows
CSV/JSON iteration data, folder selection, and JSON/JUnit reporters make collection runs suitable for automated build pipelines.
For moving Postman-authored API tests into CI
Newman fits teams that want to reuse Postman Collections in pull-request and release checks instead of rewriting them in another test framework.
Sources: [2]
Handle credentials and TLS verification deliberately
Pass API keys and tokens through CI secrets or environments rather than committing them into collections. --insecure disables SSL verification, so trusted CA configuration is preferable.
Sources: [2]
Official sources
- [1]postmanlabs/newman repository(2026-09-20)
- [2]Newman README(2026-09-20)
- [3]Newman package license metadata(2026-09-20)
- [4]Postman Newman documentation(2026-09-20)
Supplemental curator note
Newman is useful when Postman-authored requests and tests need to run unchanged in CI. JUnit and JSON reporters integrate results with build systems. Avoid routine use of `-k/--insecure`; configure trusted CAs instead when possible.
Try it in 3 steps
- 1
Install Newman
Install the Newman CLI in a Node.js 16+ environment.
npm install -g newman - 2
Prepare a Postman Collection
Export a collection you own from Postman. Keep tokens and passwords in environments or CI secrets rather than committing them into the collection.
Export a Postman Collection as collection.json - 3
Run the tests from the CLI
Produce CLI and JUnit output and verify that the same collection can run locally or in CI.
newman run collection.json --reporters cli,junit
Growth
Growth trends · Last 30 days
7,251 Stars
Trend data is still being collected.
Development activity
Last 90 days · weekly
- Commits (last 30 days)
- 0
- Open PRs
- 85
- Issues opened
- 7
- Issues closed
- 1
- PRs opened
- 16
- PRs merged
- 0
Issues
7 / 1
Pull requests
16 / 0
Maintenance
- Median first response
- Not specified
- Issue response rate
- 0% (0/7)
Based on up to the 100 newest issues opened by external users in the last 90 days. A first comment from an OWNER, MEMBER, or COLLABORATOR counts as a response; issues whose full comment history cannot be checked are excluded. The median and response rate update weekly.
Built with
Categories and tags
Categories
GitHub data
GitHub dataView detailed GitHub data
GitHub Topics
- newman
- postman-collection
- json-report
- postman
- api-testing
- api-test
- jenkins
- ci
- Stars
- 7,251
- Forks
- 1,230
- Watchers
- 163
- Open issues
- 256
- Contributors
- 100
- Primary language
- JavaScript
- License
- Apache-2.0
- Repository last updated
- Sep 18, 2026
Related information
Write a related articleShare a guide or use case for this OSS in Markdown. Articles are published after administrator approval.
Explore next
- Firecrawl182,282 Stars
A web scraping and crawling API that turns websites into LLM-ready data.
TypeScript - Axios109,205 Stars
A Promise-based HTTP client for browsers and Node.js with interceptors, adapters, cancellation, and transport controls.
JavaScript - FastAPI102,468 Stars
A Python web framework that derives validation, OpenAPI, and interactive API docs from type hints.
Python - Playwright96,362 Stars
A web automation platform spanning Chromium, Firefox, and WebKit E2E tests, scripts, a coding-agent CLI, and MCP through one API.
TypeScript - Storybook91,098 Stars
A frontend workshop that isolates UI components and reuses stories across development, Docs, interaction, visual, and accessibility testing.
TypeScript
Report incorrect information
Tell us if any listing information is incorrect or outdated.