# Access with Postman

### Setting up access using Postman​ <a href="#setting-up-access-using-postman" id="setting-up-access-using-postman"></a>

As an alternative to use Swagger, the integration API can be accessed via [Postman](https://www.postman.com/) by importing the swagger definition. Postman is a free of charge tool and can either be [downloaded as a standalone tool](https://www.postman.com/downloads) or you can create a new user (for free) and [use it online](https://web.postman.co/home).

Either way, you will need to do three things before starting using Postman: Importing the REST MapsIndoors Integration API definition, tell postman where to make it's calls and finally set up Autorization for it.

#### Importing to Postman​ <a href="#importing-to-postman" id="importing-to-postman"></a>

The first thing you need before getting started is importing the Mapsindoors Integration API definition to Postman. First click import, paste this link and click import:

> <https://integration.mapsindoors.com/swagger/v1/swagger.json>

<figure><img src="/files/QQAutTaCVibwcBiyHPYC" alt=""><figcaption></figcaption></figure>

#### Direct Postman to the API.​ <a href="#direct-postman-to-the-api" id="direct-postman-to-the-api"></a>

Now a new collection called "Integration API" will be created. Select it and change the Variable "baseUrl" to: [https://integration.mapsindoors.com](https://integration.mapsindoors.com/)

> ***NOTE:*** ⚠️ Remember to save changes! click the floppy disk icon.

!\[Postman BaseVariable]\({{ site.url }}/assets/api/v1/postmanbasevariable.png)

<figure><img src="/files/NcToUClxGV2RuJT12TQa" alt=""><figcaption></figcaption></figure>

#### Setup Postman authorization​ <a href="#setup-postman-authorization" id="setup-postman-authorization"></a>

Finally we need to set authorization up for it. Go to the Authorization tab and change "Type" from No Auth to OAuth2. Here select Password Credentials as Grant Type.

Now set the:

* "Access Token URL" to `https://auth.mapsindoors.com/connect/token`
* "Client ID" to `client`
* Username to your username used in the [CMS](https://cms.mapsindoors.com/).
* Password to your password
* Scope to `integration`

Click "Get New Access Token" and a postman will log in using your credentials. Be sure to save your changes again by clicking the floppy disk icon.

<figure><img src="/files/ddwTnzHafjB3f8GkY8SQ" alt=""><figcaption></figcaption></figure>

If you use client credentials you will need to select "Client Credentials" as you Grant type and add your ClientID (Ask us if you don't have one) and you Client Secret like this:\\

<figure><img src="/files/e4X4udszdvq7xTMHVvHE" alt=""><figcaption><p>Client Credential Flow example</p></figcaption></figure>

See the client credentials flow for more details:

{% content-ref url="/pages/375sTX2GAu0ZKVyAgvBY" %}
[Client credentials flow](/sdks-and-frameworks/integration-api/integration-api-access/client-credentials-flow.md)
{% endcontent-ref %}

You should now be able to access your MapsIndoors data in Postman.

<figure><img src="/files/RDtlydwMcphL9zYH80fD" alt=""><figcaption></figcaption></figure>

<figure><img src="https://docs.mapsindoors.com/img/api/postmanGetExample.png" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mapsindoors.com/sdks-and-frameworks/integration-api/integration-api-access/access-with-postman.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.