> For the complete documentation index, see [llms.txt](https://guide.transmute.industries/verifiable-data-platform/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.transmute.industries/verifiable-data-platform/technical-documentation/getting-started-postman-collection.md).

# Getting Started Postman Collection

This page covers importing and running the API collection in Postman

You will need to have [Postman](https://www.postman.com/) installed to run this tutorial. See the [Download](https://www.postman.com/downloads/) page for you operating system. 

## Import Postman Collection

This Postman collection is meant to get you quickly up and running and familiarized with the basics of the API.

{% file src="/files/VYAGNNj21HwiHNhptW67" %}
Getting started postman collection.
{% endfile %}

You can import this into Postman with File -> Import, or with Import button.

<figure><img src="https://362859350-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCnepINstRR3UUYDZWIj%2Fuploads%2FG3Mm5fF8q4mnFxljvfsA%2FScreenshot%20from%202024-07-23%2013-17-09.png?alt=media&amp;token=19c3bc67-13e2-4e28-971d-45d843bd6beb" alt="Click on File -> Import to import a .JSON collection"><figcaption><p>Click on File -> Import to import a .JSON collection</p></figcaption></figure>

From there, you will be presented with an area to drag and drop the Postman collection JSON file, or click on the area and select the t`ransmute-getting-started.postman_collection.json` file.

<figure><img src="https://362859350-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCnepINstRR3UUYDZWIj%2Fuploads%2FUbJXYGWHNTNB6ztcM1wT%2FScreenshot%20from%202024-07-23%2013-18-58.png?alt=media&amp;token=b6a81a68-6b55-4bbd-836b-f7ff59edf74b" alt="Select JSON Postman collection to run it"><figcaption><p>Select JSON Postman collection to run it</p></figcaption></figure>

You will then have the Postman collection imported.

<figure><img src="https://362859350-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCnepINstRR3UUYDZWIj%2Fuploads%2FM6X6K2r6wIHfgK3i8FX1%2FScreenshot%20from%202024-07-23%2013-20-16.png?alt=media&amp;token=bc810eac-e1e3-482e-b820-3d1d850f5244" alt=""><figcaption><p>Transmute collection imported into Postman</p></figcaption></figure>

Next we will cover how to set up an environment to start calling the API.&#x20;

## Import Environment

You need an Application with suitable scopes to run the collection. For full details, please consult the [guide section on Applications](https://guide.transmute.industries/verifiable-data-platform/technical-documentation/applications) for details on managing platform Applications. &#x20;

On the Transmute platform, go to Applications, and create a new Application. Select the \`Credentials\`, \`Presentations\`, and \`Organizations\` scopes which are required to run the collection. Click "Create Application" and download the Postman environment.&#x20;

In Postman, import the environment file as an Environment. Select it as the active environment in the top-right drop down. &#x20;

## Postman Collection Functionality

To run the collection, click on the three dots next to "Transmute Getting Started", and then click on "Run Collection.&#x20;

<figure><img src="https://362859350-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCnepINstRR3UUYDZWIj%2Fuploads%2FIqHv0hSjuhJlvtgpr9UO%2FScreenshot%20from%202024-07-23%2013-32-05.png?alt=media&amp;token=0e8954a1-e7fb-461b-a567-634f3030fd93" alt="Navigating to running the collection. "><figcaption><p>Navigating to running the collection. </p></figcaption></figure>

To run the entire collection, right-click the Collection and choose Run Collection to run all the endpoints in order.&#x20;

<figure><img src="https://362859350-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCnepINstRR3UUYDZWIj%2Fuploads%2FMG8IJ8l1mE44oeQNXSNE%2FScreenshot%20from%202024-07-23%2013-35-10.png?alt=media&amp;token=df4a0546-dc62-4253-98d9-525be270a885" alt="Running the Getting Started Postman Collection"><figcaption><p>Running the Getting Started Postman Collection</p></figcaption></figure>

The Postman collection calls some basic network requests to the API:

* First obtains an access token for the application
* Queries and resolves the default did:web
* Issues a sample Verifiable Credential
* Illustrates different Verifiable Credential media type representations
* Verifies retuned and referenced Verifiable Credentials
* Signs a Verifiable Presentation
* Submits a Verifiable Presentation