> 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/introduction/getting-started/postman-collections.md).

# Postman collections

{% hint style="warning" %}
These Postman collections are compatible with iSHARE 2.0. An updated version will be available and published here soon.
{% endhint %}

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

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

{% file src="/files/ZGRhVrR5P3ZpTitXcq7U" %}
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 %}

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

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

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

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

{% file src="/files/QxrJmNP9TMzzFPKWhtNr" %}
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/vrAd1q2IIcFtZPxJjaIA" %}
Globals
{% endfile %}

{% file src="/files/cXWA5DaW6gzMcry7yRhY" %}
Environment
{% 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, and 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="info" %}
There is a Walkthrough of the Postman Collection in the [Trust Body of Knowledge](https://trustbok.ishare.eu/apply-ishare/quick-walkthroughs/postman-collections).
{% endhint %}