Reference requests and examples in local mock servers

The pm.mock object provides structured, Postman-aware functions for matching incoming requests and sending responses with a local mock server. The pm.mock API can serve responses from your existing saved Postman examples rather than hard-coding everything.

pm.mock

Use the pm.mock methods to match incoming requests and send responses, including responses from your existing saved Postman examples.

In the following examples, <request-path> and <example-path> are placeholders for the path to a saved request and example in your local Git repo. The example’s status code, headers, and body are all sent as the response.

Rather than looking up paths manually, Postman provides a searchable dropdown directly in the mock code editor. When you click the argument, a dropdown list displays where you can search your workspace’s requests and examples by name or path.

pm.mock.matchRequest()

Matches an incoming request against a Postman request by its method and path. Returns true if the incoming request matches the specified criteria.

Example:

1
if (pm.mock.matchRequest('<request-path>', req)) {
2
  res.status(200).json([{ id: 1, name: 'Alice' }]);
3
  return;
4
}

pm.mock.sendExample()

Sends a saved Postman example as the HTTP response. This is the key integration point between your existing Postman collection data and your mock server.

1
if (pm.mock.matchRequest('<request-path>', req)) {
2
  pm.mock.sendExample('<example-path>', res);
3
  return;
4
}

Below is a complete example using the pm.mock API:

1
// Match GET /users and serve the saved "List Users - 200 OK" example
2
if (pm.mock.matchRequest('<get-users-request-path>', req)) {
3
  pm.mock.sendExample('<list-users-200-example-path>', res);
4
  return;
5
}
6
7
// Match GET /users/:id with a path variable
8
if (pm.mock.matchRequest('<request-path>', req)) {
9
  if (req.params.id === '999') {
10
    res.status(404).json({ error: 'User not found' });
11
  } else {
12
    pm.mock.sendExample('<get-user-200-example-path>', res);
13
  }
14
  return;
15
}
16
17
// Match POST /users
18
if (pm.mock.matchRequest('<request-path>', req)) {
19
  pm.mock.sendExample('<create-user-201-example-path>', res);
20
  return;
21
}
22
23
res.status(404).json({ error: 'Route not matched' });

Path variable matching

The matching algorithm supports path variables, which are URL segments prefixed with : that match any value in that position.

Example:

1
// Matches /products/42, /products/abc, /products/anything
2
if (pm.mock.matchRequest('<request-path>', req)) {
3
  console.log('Requested product ID:', req.params.id);
4
  res.status(200).json({ id: req.params.id, name: 'Example Product' });
5
  return;
6
}
7
8
// Nested path variables also work
9
if (pm.mock.matchRequest('<request-path>', req)) {
10
  res.status(200).json({
11
    orgId: req.params.orgId,
12
    userId: req.params.userId
13
  });
14
  return;
15
}