> This page is for Postman Docs, version Latest (v12) (default).
> For other versions, use one of these documentation indexes:
> - Latest (v12) (default): https://learning.postman.com/latest-v-12/llms.txt
> - v11: https://learning.postman.com/v11/llms.txt

> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://learning.postman.com/llms.txt.

# Configure request and collection runs using the Postman Runtime library

The Postman Runtime library is an [open-source Node.js project](https://github.com/postmanlabs/postman-runtime/) you can use for low-level configuration over request sending in your API development and testing projects. It supports request sending and [collection running](/docs/tests-and-scripts/running-collections/intro-to-collection-runs/) in Postman and other interfaces including the [Postman CLI](/docs/postman-cli/postman-cli-overview/).

## Accessing the Postman Runtime library

To get started with the Runtime library, check out the repo's [README](https://github.com/postmanlabs/postman-runtime).

You can install the library from [npm](https://www.npmjs.com/package/postman-runtime). The following example code shows a simplified outline of using the Runtime library in conjunction with the [Collection SDK](/docs/reference/developer-resources/collection-sdk/):

```js
runtime = require('postman-runtime');
var runner = new runtime.Runner();

// Collection object constructed using the Collection SDK
var collection = new sdk.Collection();

runner.run(collection, {
  data: [],
  timeout: {
    request: 30000,
    script: 5000
  },
  iterationCount: 1,

  //other options...

},
function (err, run) {
  // Callbacks to run as the collection runs
  run.start(callbacks);
});
```

You can use the Runtime library if you need a detailed configuration of your request runs. For example, it can be used as part of an automation workflow to integrate Postman Collection runs into your development pipeline.

> **Info**
>
> Note that if you only need to run collections, you can use [the Postman CLI](docs/postman-cli/postman-cli-overview/).

## Next steps

After you've gotten started with the Runtime library, you might also want to use the [Postman API](/docs/reference/postman-api/intro-api/) in your continuous integration and continuous deployment (CI/CD) workflow:

* To learn more about incorporating Postman into your CI/CD workflow, visit [Postman CLI overview](/docs/postman-cli/postman-cli-overview/).