> For the complete documentation index, see [llms.txt](https://dev.ishare.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.ishare.eu/version-2.0.1/reference/postman-collections.md).

# Postman collections

This section contains various Postman collections, which can be used to manually test iSHARE APIs. In these collections, you as a user are impersonating Test participant ‘ABC Trucking’.

In order to impersonate ABC Trucking, these Postman collections contain the private key of ABC Trucking. For non-dummy parties, private keys should never be shared with the Scheme Owner or other iSHARE Parties

Each collection contains all API endpoints of a specific Test participant, and as ABC Trucking you are able to consume these API endpoints.

### Downloads

In order for the collections to work, please download iSHARE `environment` and `globals`. Then download the following Postman collections:

{% file src="/files/oZ2hlSkWnABPDmId44uw" %}
Environment
{% endfile %}

{% file src="/files/oBgTKbM3svs6tzqxKSki" %}
Globals
{% endfile %}

{% file src="/files/TPCF1yfaA9QLjgo4MtW7" %}
ABC Trucking and the Satellite (from iSHARE Trust Framework version 2.x onwards)and its related [`environment`](https://dev.ishare.eu/_downloads/ca3b072f85efad28432ec31bb8689eb9/13feb2024_iSHARE_satellite_PIR_Test_env.postman_collection.json)
{% endfile %}

{% file src="/files/cx7V6JRpL7HCd9Rxt1jp" %}
ABC Trucking and Warehouse 13 Postman collection
{% endfile %}

{% file src="/files/V4ha8u2Z0xdXDgOvMprr" %}
ABC Trucking and the Authorization Registry Postman collection
{% endfile %}

{% file src="/files/wF53MVt48ywYuQvZ9Eje" %}
ABC Trucking and Awesome Widgets Postman collection
{% endfile %}

{% file src="/files/lwFdhsQWgy91IgZT1bp3" %}
End-2-End flow: ABC Trucking gets container data from Warehouse 13 (Service Provider requests Delegation Evidence) Postman collection
{% endfile %}

{% file src="/files/mcNTSQWkQtCixBWwwjQ7" %}
End-2-End flow: ABC Trucking gets container data from Warehouse 13 (Service Consumer provides Delegation Evidence) (Service Provider requests Delegation Evidence) Postman collection
{% endfile %}

### Instructions

To request an access token:

* Open the /token request
* The client\_assertion is generated in the background
* Run the request without making additional changes, the response should contain (among others) an access token value

To request a service:

* Open a service request
* The access token is automatically copied.
* Run the request, the response should contain (an encoded) response
* If the response is encoded, decode the token via [jwt.io](https://www.jwt.io/) and inspect the results

{% hint style="success" %}
**Tip**

For /delegation service requests please view the demo in the [video section](https://gitlab.com/ishare-foundation/cab/developer-portal/-/blob/v2.0.1/reference/broken-reference/README.md), this will explain how authorization in iSHARE can work and Postman examples are shown.
{% endhint %}