Enrich tracking from DHL
The DHL Shipment Tracking API is used to provide up-to-the-minute shipment status reports by retrieving tracking information for shipments, identifying DHL service providers, and verifying DHL delivery addresses.
DHL is a beta integration which requires a slightly more involved setup process than our native integrations. Following the guidance in this document should help even those without technical experience pull data from DHL. If you run into any questions, shoot our team an email at support@parabola.io.
Use Cases
🤝 DHL | Integration configuration
📖 DHL Reference docs:
https://developer.dhl.com/api-reference/shipment-tracking#reference-docs-section
🔐 DHL Authentication doc links:
https://developer.dhl.com/api-reference/shipment-tracking#get-started-section/user-guide
Instructions
1. Click My Apps on the portal website.
2. Click the + Add App button.
3. The “Add App” form appears.
4. Complete the Add App form.
5. You can select the APIs you want to access.
6. When you have completed the form, click the Add App button.
7. From the My Apps screen, click on the name of your app. The Details screen appears.
8. If you have access to more than one API, click the name of the relevant API.
⚠️ Note: The APIs are listed under the Credentials section.
9. Click the Show link below the asterisk that is hiding the Consumer Key.
🔐 Parabola | Authentication configuration
1. Add an Enrich tracking from DHL step template to your canvas.
2. Click into the Enrich with API: DHL Tracking step to configure your authentication.
3. Under the Authentication Type, select None.
4. Click into the Request Settings to configure your request using the format below:
Request Headers
Example Screenshot
🌐 DHL | Sample API Requests
Track DHL Shipment Statuses by tracking number
Get started with this template.
Test URL
https://api-test.dhl.com/track/
Production URL
https://api-eu.dhl.com/track/
1. Add a Use sample data step to your Flow. You can also import a dataset with tracking numbers into your Flow. (Pull from Excel File, Pull from Google Drive, Pull from API, Use sample data, etc.)
💡 Tip: When using your own data, use the Edit columns step to rename the tracking column in your source data to Tracking Number.
2. Connect it to the Enrich with API: DHL Tracking step.
3. Under Authentication Type, select None.
4. Click into the Request Settings to configure your request using the format below:
API Endpoint URL
💡 Tip: The Enrich with API step makes dynamic requests for each row in the table by inserting the tracking number in the API Endpoint URL.
The example above assumes, there is a Tracking Number column and is referenced using curly brackets:{Tracking Number}
Enclose your column header containing tracking numbers with curly brackets to dynamically reference the tracking numbers in your table.
Request Headers
5. Click Refresh data to display the results.
Example Screenshot
📣 Callouts
⚠️ Note: Rate limits protect the DHL infrastructure from suspicious requests that exceed defined thresholds.
When you first request access to the API, you will get the initial service level which allows 250 calls per day with a maximum of 1 call every 5 seconds.
Additional rate limits are available and they are granted according to your specific use case. If you would like to request for additional limits, please proceed with the following steps:
1. Create an app as described under the Get Access section.
2. Click My Apps on the portal website.
3. Click on the App you created.
4. Scroll down to the APIs list and click on the "Request Upgrade" button.
