API docs / Endpoints

Find out if a shipment between two countries is dutiable, before you create it.

curl --request GET 'https://services.parcelparcel.com/partners-api/v1/dutiable-route/NL/US/NONDOC' \
  --header 'X-PP-API: {YourAPIKey}@{YourAPISecret}' \
  --header 'Content-Type: application/json'

const response = await fetch("https://services.parcelparcel.com/partners-api/v1/dutiable-route/NL/US/NONDOC", {
  method: "GET",
  headers: {
    "X-PP-API": "{YourAPIKey}@{YourAPISecret}",
    "Content-Type": "application/json",
  },
});
const data = await response.json();
console.log(data);

import requests

response = requests.get(
    "https://services.parcelparcel.com/partners-api/v1/dutiable-route/NL/US/NONDOC",
    headers={
        "X-PP-API": "{YourAPIKey}@{YourAPISecret}",
        "Content-Type": "application/json",
    },
)
print(response.json())

A shipment is dutiable when it goes through customs. For a dutiable shipment you need more information when you create it: reasonForExport and incoterms are required, and the contentItems (description, value, country of origin and HS code) go on the customs documents.

With this endpoint you know up front whether that's the case, so your integration only asks for customs details when they're needed.

#How we decide

A shipment is dutiable when both of these are true:

1. At least one of the two countries is outside the EU. Within the EU, goods move without customs.
2. It's not a document shipment. Documents (DOC) never count as dutiable here.

We follow our own country list. Besides countries such as the United Kingdom, Switzerland and Norway, some areas that belong to an EU country also count as outside the EU, because they are outside the EU customs area: the Canary Islands (IC), Ceuta and Melilla (EA), the French overseas regions (GP, MQ, RE, GF, YT) and Åland (AX). Use their own country code, not the one of the mainland. Guernsey (GG), Jersey (JE) and Gibraltar (GI) are outside the EU too.

#Header

You need to add the following headers:

Don't you have an API Key and API Secret yet? Check our Authentication page.

#Path parameters

There is no body. You put everything in the URL:

For example:

https://services.parcelparcel.com/partners-api/v1/dutiable-route/NL/US/NONDOC

#Response

If a country code or parcel type isn't recognised, you get an error instead of data.dutiable. Check that you use 2-letter ISO country codes and one of the three parcel types.

#Example response

{
  "errors": false,
  "message": "Query processed successfully",
  "data": {
    "dutiable": true
  }
}

#Next steps

• Dutiable? Add reasonForExport, incoterms and complete contentItems when you create the shipment.
• Want to know the costs? Estimate the duties and taxes for the goods in the shipment.

#Examples

Don't know how to test these requests? Check our guide.

#Request example - Parcel from the Netherlands to the United States

curl --location --request GET 'https://services.parcelparcel.com/partners-api/v1/dutiable-route/NL/US/NONDOC' \
--header 'X-PP-API: {YourAPIKey}@{YourAPISecret}' \
--header 'Content-Type: application/json'

GET /partners-api/v1/dutiable-route/NL/US/NONDOC HTTP/1.1
Host: services.parcelparcel.com
X-PP-API: {YourAPIKey}@{YourAPISecret}
Content-Type: application/json

#Request example - Parcel from the Netherlands to Germany

curl --location --request GET 'https://services.parcelparcel.com/partners-api/v1/dutiable-route/NL/DE/NONDOC' \
--header 'X-PP-API: {YourAPIKey}@{YourAPISecret}' \
--header 'Content-Type: application/json'

GET /partners-api/v1/dutiable-route/NL/DE/NONDOC HTTP/1.1
Host: services.parcelparcel.com
X-PP-API: {YourAPIKey}@{YourAPISecret}
Content-Type: application/json

This one returns "dutiable": false: both countries are in the EU.