For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Postman
PricingEnterprise
Contact SalesSign InSign Up for Free
HomeDocs
HomeDocs
      • Overview
      • Schemas
        • Overview
        • Install
          • Overview
          • Basic CLI commands
          • Authentication commands
          • Workspace commands
          • Collection commands
          • Request commands
          • Monitoring and performance commands
          • Application commands
          • Flows commands
          • API governance commands
          • Mock server commands
          • Simulator commands
          • Publish API versions commands
        • Built-in reporters
        • Postman CLI GitHub Action
Postman API Platform

Product

  • Postman Overview
  • Enterprise
  • Spec Hub
  • Flows
  • Agent Mode
  • API Catalog
  • Fern
  • Postman CLI
  • Integrations
  • Workspaces
  • Plans and pricing

API Network

  • App Security
  • Artificial Intelligence
  • Communication
  • Data Analytics
  • Database
  • Developer Productivity
  • DevOps
  • Ecommerce
  • eSignature
  • Financial Services
  • Payments
  • Travel

Resources

  • Postman Docs
  • Academy
  • Community
  • Templates
  • Intergalactic
  • Videos
  • MCP Servers

Legal and Security

  • Legal Terms Hub
  • Terms of Service
  • Postman Product Terms
  • Security
  • Website Terms of Use

Company

  • About
  • Careers and culture
  • Contact us
  • Partner program
  • Customer stories
  • Student programs
  • Press and media
Twitter iconLinkedIn iconGithub iconYouTube iconInstagram iconDiscord icon
Download Postman
Privacy Policy

© 2026 Postman, Inc.

On this page
  • postman simulate run
Postman CollectionsPostman CLICLI commands

Simulator commands

Beta
||View as Markdown|
Was this page helpful?
Previous

Mock server commands

Next

Publish API versions commands

Built with

Postman Simulator is available on Postman Solo, Team, and Enterprise plans. For more information, see the pricing page.

This topic covers simulator commands for the Postman CLI.

postman simulate run

You can use the postman simulate run command to start a local mock server with a simulation applied to it. This enables you to observe how your service responds to disruptions and performance constraints. With simulations, you can identify and fix issues before deploying to staging or production.

The command runs the simulator configuration file that defines the mock server and selected scenarios for simulating real-world conditions.

Add this command to your CI/CD script to run your service against simulated dependencies. This enables you to catch issues related to latency, errors, and rate limits before changes are deployed. Once running, your service or external tests can send requests to the mock server URL and observe the responses with the simulated conditions applied.

To run a collection with a simulation, use the --simulate option with the postman collection run command.

To create a simulation and apply it to a mock server, see Simulate real-world conditions in Postman.

Usage

$postman simulate run <simulation-name>.sim.yaml
<simulation-name>

The path to the <simulation-name>.sim.yaml configuration file.

Example

$postman simulate run postman/simulations/<simulation-name>.sim.yaml