# Postman Collection

> Import our Postman Collection and try every endpoint without writing code.

Our Postman Collection contains a ready-made request for every endpoint, with the same examples as these docs.

## What is Postman?

[Postman](https://www.postman.com/) is an API platform for building and using APIs. You can download Postman on [this page](https://www.postman.com/downloads/).

## Import the collection

1. Download the collection: [parcelparcel-api.postman_collection.json](/api-docs/parcelparcel-api.postman_collection.json).
2. In Postman, click **Import** and drop the file in the window. You can also paste this link in the Import window:

   ```text
   https://www.parcelparcel.com/api-docs/parcelparcel-api.postman_collection.json
   ```

3. Open the **ParcelParcel API** collection and go to the **Variables** tab. Fill in your own `apiKey` and `apiSecret`. Tip: start with your sandbox key. Don't know where to find them? Check our [Authentication](https://www.parcelparcel.com/api-docs/authentication/) page.
4. Open a request and click **Send**.

The collection has a folder per endpoint. For [Cancel a shipment](https://www.parcelparcel.com/api-docs/cancel-shipment/) and [Get the shipping documents](https://www.parcelparcel.com/api-docs/shipping-documents/), set the `shipmentId` variable to the `id` you got when you created the shipment. For [Track a shipment](https://www.parcelparcel.com/api-docs/track-shipment/), set `trackingNumber`.

> [!warning] Booking is for real
> The request "Parcel shipment (booked directly)" has `bookShipment: true`. With your live key, sending it books a real shipment at the carrier on your account. Use your [sandbox key](https://www.parcelparcel.com/api-docs/authentication/#test-with-your-sandbox-key) to try it safely: nothing is sent to the carrier. The other create requests only make a draft.