{
  "info": {
    "name": "ParcelParcel API",
    "description": "Requests for the ParcelParcel partners API. Fill in apiKey and apiSecret under Variables first. Docs: https://www.parcelparcel.com/api-docs/",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    {
      "name": "Check your API key",
      "item": [
        {
          "name": "Check which account your key belongs to",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-PP-API",
                "value": "{{apiKey}}@{{apiSecret}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "https://services.parcelparcel.com/partners-api/v1/me",
            "description": "See which ParcelParcel account your API key belongs to.\n\nDocs: https://www.parcelparcel.com/api-docs/me/"
          }
        }
      ]
    },
    {
      "name": "Compare shipping options",
      "item": [
        {
          "name": "Get shipping options for a parcel shipment from the Netherlands to the United States",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-PP-API",
                "value": "{{apiKey}}@{{apiSecret}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "https://services.parcelparcel.com/partners-api/v1/rates",
            "description": "Get shipping rates from ParcelParcel\n\nDocs: https://www.parcelparcel.com/api-docs/compare-shipping-options/",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"parcels\": [\n    {\n      \"type\": \"NONDOC\",\n      \"weight\": \"1.5\",\n      \"height\": \"10\",\n      \"width\": \"10\",\n      \"length\": \"10\",\n      \"count\": \"1\"\n    }\n  ],\n  \"fromCountry\": \"NL\",\n  \"fromZipcode\": \"1411 AT\",\n  \"fromCity\": \"Naarden\",\n  \"toCountry\": \"US\",\n  \"toZipcode\": \"10001\",\n  \"toCity\": \"New York\",\n  \"insured\": true,\n  \"totalValue\": 100\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Get shipping options for a document shipment from the Netherlands to the United States",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-PP-API",
                "value": "{{apiKey}}@{{apiSecret}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "https://services.parcelparcel.com/partners-api/v1/rates",
            "description": "Get shipping rates from ParcelParcel\n\nDocs: https://www.parcelparcel.com/api-docs/compare-shipping-options/",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"parcels\": [\n    {\n      \"type\": \"DOC\",\n      \"count\": \"1\"\n    }\n  ],\n  \"fromCountry\": \"NL\",\n  \"fromZipcode\": \"1411 AT\",\n  \"fromCity\": \"Naarden\",\n  \"toCountry\": \"US\",\n  \"toZipcode\": \"10001\",\n  \"toCity\": \"New York\",\n  \"insured\": false,\n  \"totalValue\": 100\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Get shipping options for a pallet shipment from the Netherlands to the United States",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-PP-API",
                "value": "{{apiKey}}@{{apiSecret}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "https://services.parcelparcel.com/partners-api/v1/rates",
            "description": "Get shipping rates from ParcelParcel\n\nDocs: https://www.parcelparcel.com/api-docs/compare-shipping-options/",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"parcels\": [\n    {\n      \"type\": \"PALLET\",\n      \"weight\": \"80\",\n      \"height\": \"120\",\n      \"width\": \"120\",\n      \"length\": \"100\",\n      \"count\": \"1\",\n      \"stackable\": false\n    }\n  ],\n  \"recipientType\": \"business\",\n  \"fromCountry\": \"NL\",\n  \"fromZipcode\": \"1411 AT\",\n  \"fromCity\": \"Naarden\",\n  \"toCountry\": \"NL\",\n  \"toZipcode\": \"1052LP\",\n  \"toCity\": \"Amsterdam\",\n  \"insured\": false,\n  \"totalValue\": 100\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Create a (draft) shipment",
      "item": [
        {
          "name": "Parcel shipment from the Netherlands to France",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-PP-API",
                "value": "{{apiKey}}@{{apiSecret}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "https://services.parcelparcel.com/partners-api/v1/shipments",
            "description": "Create a draft shipment or book your shipment directly in ParcelParcel.\n\nDocs: https://www.parcelparcel.com/api-docs/create-shipment/",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"parcels\": [\n    {\n      \"type\": \"NONDOC\",\n      \"weight\": \"20\",\n      \"height\": \"10\",\n      \"width\": \"74\",\n      \"length\": \"84\",\n      \"count\": \"1\"\n    }\n  ],\n  \"contentItems\": [\n    {\n      \"description\": \"This is a description of an content item\",\n      \"quantity\": \"1\",\n      \"price\": \"1600.00\",\n      \"country\": \"NL\"\n    },\n    {\n      \"description\": \"This is a description of an content item\",\n      \"quantity\": \"1\",\n      \"price\": \"1600.00\",\n      \"country\": \"NL\",\n      \"hsCode\": \"61091000\"\n    }\n  ],\n  \"reasonForExport\": \"commercial\",\n  \"reference\": \"#123126\",\n  \"currency\": \"EUR\",\n  \"incoterms\": \"DAP\",\n  \"pickupAddress\": {\n    \"countryCode\": \"NL\",\n    \"companyName\": \"ParcelParcel\",\n    \"contactPerson\": \"John Doe\",\n    \"email\": \"info@parcelparcel.com\",\n    \"phone\": \"+31858771656\",\n    \"addressLine1\": \"Energiestraat 14E\",\n    \"addressLine2\": \"Extra details-\",\n    \"zipcode\": \"1411 AT\",\n    \"city\": \"Naarden\"\n  },\n  \"destinationAddress\": {\n    \"countryCode\": \"FR\",\n    \"companyName\": \"Company x\",\n    \"contactPerson\": \"John Croissant\",\n    \"email\": \"johncroissant@hotmail.com\",\n    \"phone\": \"+5218112278399\",\n    \"addressLine1\": \"Rue de Baquette 34\",\n    \"addressLine2\": \"Dans la rue\",\n    \"zipcode\": \"75001\",\n    \"vatNumber\": \"0000\",\n    \"city\": \"Paris\"\n  },\n  \"schedulePickup\": 1,\n  \"pickupDate\": \"2026-11-05\",\n  \"pickupTimeFrom\": \"12:00\",\n  \"pickupTimeTo\": \"16:00\",\n  \"pickupInstructions\": \"Ring the bell\",\n  \"insured\": 0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Parcel shipment from the Netherlands to the United States",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-PP-API",
                "value": "{{apiKey}}@{{apiSecret}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "https://services.parcelparcel.com/partners-api/v1/shipments",
            "description": "Create a draft shipment or book your shipment directly in ParcelParcel.\n\nDocs: https://www.parcelparcel.com/api-docs/create-shipment/",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"parcels\": [\n    {\n      \"type\": \"NONDOC\",\n      \"weight\": \"9.6\",\n      \"height\": \"10\",\n      \"width\": \"74\",\n      \"length\": \"84\",\n      \"count\": \"1\"\n    }\n  ],\n  \"contentItems\": [\n    {\n      \"description\": \"Awesome Product\",\n      \"quantity\": \"1\",\n      \"price\": \"69.00\",\n      \"hsCode\": \"61091000\",\n      \"country\": \"NL\"\n    }\n  ],\n  \"reasonForExport\": \"commercial\",\n  \"reference\": \"#123126\",\n  \"currency\": \"EUR\",\n  \"incoterms\": \"DAP\",\n  \"pickupAddress\": {\n    \"countryCode\": \"NL\",\n    \"companyName\": \"CompanyOne\",\n    \"contactPerson\": \"John Doe 1\",\n    \"email\": \"johndow@example.com\",\n    \"phone\": \"+31858771656\",\n    \"addressLine1\": \"street Name ...\",\n    \"addressLine2\": \"extra details\",\n    \"zipcode\": \"3542 AB\",\n    \"city\": \"Utrecht\"\n  },\n  \"destinationAddress\": {\n    \"countryCode\": \"US\",\n    \"companyName\": \"CompanyTwo\",\n    \"contactPerson\": \"John Doe\",\n    \"email\": \"johndow@example.com\",\n    \"phone\": \"+31858771656\",\n    \"addressLine1\": \"street Name ...\",\n    \"addressLine2\": \"Dover market\",\n    \"zipcode\": \"10001\",\n    \"vatNumber\": \"0000\",\n    \"city\": \"New York\"\n  },\n  \"schedulePickup\": 1,\n  \"pickupDate\": \"2026-11-05\",\n  \"pickupTimeFrom\": \"12:00\",\n  \"pickupTimeTo\": \"16:00\",\n  \"pickupInstructions\": \"Ring the bell\",\n  \"insured\": 0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Parcel shipment (booked directly) from the Netherlands to the United States",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-PP-API",
                "value": "{{apiKey}}@{{apiSecret}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "https://services.parcelparcel.com/partners-api/v1/shipments",
            "description": "Careful: with your live key this books a real shipment at the carrier. Use your sandbox key (starts with sbx_) to test.\n\nCreate a draft shipment or book your shipment directly in ParcelParcel.\n\nDocs: https://www.parcelparcel.com/api-docs/create-shipment/",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"parcels\": [\n    {\n      \"type\": \"NONDOC\",\n      \"weight\": \"9.6\",\n      \"height\": \"10\",\n      \"width\": \"74\",\n      \"length\": \"84\",\n      \"count\": \"1\"\n    }\n  ],\n  \"contentItems\": [\n    {\n      \"description\": \"Awesome Product\",\n      \"quantity\": \"1\",\n      \"price\": \"69.00\",\n      \"hsCode\": \"61091000\",\n      \"country\": \"NL\"\n    }\n  ],\n  \"reasonForExport\": \"commercial\",\n  \"reference\": \"#123126\",\n  \"currency\": \"EUR\",\n  \"incoterms\": \"DAP\",\n  \"pickupAddress\": {\n    \"countryCode\": \"NL\",\n    \"companyName\": \"CompanyOne\",\n    \"contactPerson\": \"John Doe 1\",\n    \"email\": \"johndow@example.com\",\n    \"phone\": \"+31858771656\",\n    \"addressLine1\": \"street Name ...\",\n    \"addressLine2\": \"extra details\",\n    \"zipcode\": \"3542 AB\",\n    \"city\": \"Utrecht\"\n  },\n  \"destinationAddress\": {\n    \"countryCode\": \"US\",\n    \"companyName\": \"CompanyTwo\",\n    \"contactPerson\": \"John Doe\",\n    \"email\": \"johndow@example.com\",\n    \"phone\": \"+31858771656\",\n    \"addressLine1\": \"street Name ...\",\n    \"addressLine2\": \"Dover market\",\n    \"zipcode\": \"10001\",\n    \"vatNumber\": \"0000\",\n    \"city\": \"New York\"\n  },\n  \"insured\": 0,\n  \"bookShipment\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Cancel a (draft) shipment",
      "item": [
        {
          "name": "Cancel a shipment",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-PP-API",
                "value": "{{apiKey}}@{{apiSecret}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "https://services.parcelparcel.com/partners-api/v1/shipments/{{shipmentId}}/cancel",
            "description": "Cancel a (draft) shipment directly in ParcelParcel.\n\nDocs: https://www.parcelparcel.com/api-docs/cancel-shipment/"
          }
        }
      ]
    },
    {
      "name": "Track a shipment",
      "item": [
        {
          "name": "Track a shipment with a dummy tracking number",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-PP-API",
                "value": "{{apiKey}}@{{apiSecret}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "https://services.parcelparcel.com/partners-api/v1/track/{{trackingNumber}}",
            "description": "Track shipments that are booked through MyParcelParcel.\n\nDocs: https://www.parcelparcel.com/api-docs/track-shipment/"
          }
        }
      ]
    },
    {
      "name": "List your shipments",
      "item": [
        {
          "name": "Booked DHL shipments",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-PP-API",
                "value": "{{apiKey}}@{{apiSecret}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "https://services.parcelparcel.com/partners-api/v1/shipments?status=created_at_carrier&carrier=DHL",
            "description": "Retrieve and filter all shipments linked to your ParcelParcel account.\n\nDocs: https://www.parcelparcel.com/api-docs/list-shipments/"
          }
        }
      ]
    },
    {
      "name": "Get the shipping documents (labels)",
      "item": [
        {
          "name": "Get the labels of shipment 1588448",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-PP-API",
                "value": "{{apiKey}}@{{apiSecret}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "https://services.parcelparcel.com/partners-api/v1/shipments/{{shipmentId}}/labels",
            "description": "Receive the shipping documentation in a base64 string.\n\nDocs: https://www.parcelparcel.com/api-docs/shipping-documents/"
          }
        }
      ]
    },
    {
      "name": "Estimate duties/taxes",
      "item": [
        {
          "name": "Estimate duties & taxes for a parcel shipment from the Netherlands to the United Kingdom",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-PP-API",
                "value": "{{apiKey}}@{{apiSecret}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "https://services.parcelparcel.com/partners-api/v1/duties-taxes-estimate",
            "description": "Estimate the import duties and taxes of a shipment.\n\nDocs: https://www.parcelparcel.com/api-docs/estimate-duties-taxes/",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"fromCountry\": \"NL\",\n  \"toCountry\": \"GB\",\n  \"fromCity\": \"Eindhoven\",\n  \"fromZipcode\": \"5643TW\",\n  \"toCity\": \"Gillingham\",\n  \"toZipcode\": \"ME8 0RU\",\n  \"contentItems\": [\n    {\n      \"description\": \"Cylinder head for compression-ignition diesel engine\",\n      \"numberOfItems\": 9,\n      \"cost\": 800,\n      \"tariff\": \"84099900\",\n      \"originCountry\": \"NL\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Check if a shipment goes through customs",
      "item": [
        {
          "name": "Parcel from the Netherlands to the United States",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-PP-API",
                "value": "{{apiKey}}@{{apiSecret}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "https://services.parcelparcel.com/partners-api/v1/dutiable-route/NL/US/NONDOC",
            "description": "Find out if a shipment between two countries is dutiable, before you create it.\n\nDocs: https://www.parcelparcel.com/api-docs/dutiable-route/"
          }
        },
        {
          "name": "Parcel from the Netherlands to Germany",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-PP-API",
                "value": "{{apiKey}}@{{apiSecret}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "https://services.parcelparcel.com/partners-api/v1/dutiable-route/NL/DE/NONDOC",
            "description": "Find out if a shipment between two countries is dutiable, before you create it.\n\nDocs: https://www.parcelparcel.com/api-docs/dutiable-route/"
          }
        }
      ]
    },
    {
      "name": "Webhooks",
      "item": [
        {
          "name": "Subscribe to booked shipments",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "X-PP-API",
                "value": "{{apiKey}}@{{apiSecret}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "https://services.parcelparcel.com/partners-api/v1/hooks/subscribe",
            "description": "Get a message on your own URL as soon as a shipment is booked.\n\nDocs: https://www.parcelparcel.com/api-docs/webhooks/",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"hookUrl\": \"https://example.com/parcelparcel/webhook\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Get example payloads",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "X-PP-API",
                "value": "{{apiKey}}@{{apiSecret}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "https://services.parcelparcel.com/partners-api/v1/hooks/examples",
            "description": "Get a message on your own URL as soon as a shipment is booked.\n\nDocs: https://www.parcelparcel.com/api-docs/webhooks/"
          }
        },
        {
          "name": "Unsubscribe webhook 123",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "X-PP-API",
                "value": "{{apiKey}}@{{apiSecret}}"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": "https://services.parcelparcel.com/partners-api/v1/hooks/123",
            "description": "Get a message on your own URL as soon as a shipment is booked.\n\nDocs: https://www.parcelparcel.com/api-docs/webhooks/"
          }
        }
      ]
    }
  ],
  "variable": [
    {
      "key": "apiKey",
      "value": "YourAPIKey"
    },
    {
      "key": "apiSecret",
      "value": "YourAPISecret"
    },
    {
      "key": "shipmentId",
      "value": "1"
    },
    {
      "key": "trackingNumber",
      "value": "123456789"
    }
  ]
}
