# Turn myDHLi into an API

> Read your planned and in-transit shipments, housebills, final invoices and customs declarations from myDHLi with one API call each. Or have a workflow check Track every morning and email you the shipments whose status changed overnight.

Page: https://fous.com/automate/mydhli
Updated: 2026-11-12

Works with your own myDHLi account. Fous is an independent product.

## What you can build on myDHLi

### Get shipments in Track

Reads the shipments that are planned or in transit in Track, with each one's housebill number, route, status and CO2 footprint.

- Takes: Transport mode (optional), origin or destination (optional)
- Returns: Housebill number, transport mode, origin, destination, status, CO2 footprint

### Get customs declarations

Reads import and export declarations in myDHLi's customs data down to the line item: commodities, countries of origin, duties, taxes and key milestones.

- Takes: Import or export, date range
- Returns: Declaration, housebill number, line items, commodity, country of origin, duties, taxes, milestones

### List a shipment's documents

Reads the documents myDHLi collects for one shipment, from quote details to the housebill and the final invoice.

- Takes: Housebill number
- Returns: Housebill number, document type, document name

### Request a quote in Quote + Book

Fills in a Quote + Book request for Air Freight or Ocean Freight FCL or LCL and reads the offers with their price, transit time and emissions.

- Takes: Origin, destination, transport mode, total weight, total volume
- Returns: Offer, price, currency, transit time, CO2 emissions, quote validity

## Automate myDHLi with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### Track status changes, every weekday morning

Starts: Every weekday at 7:00

1. Get the planned and in-transit shipments in Track.
2. Keep the shipments whose status changed since the last run.
3. Email you the list with housebill number, transport mode, origin, destination and new status.

### Weekly duties and taxes, sent to your ERP

Starts: Every Monday at 8:00

1. Get last week's import declarations from myDHLi's customs data.
2. Group the line items by country of origin and add up duties and taxes.
3. Post the totals and the declarations to your ERP webhook.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get shipments in Track” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "app.mydhli.com/get_tracked_shipments",
    "input": {
      "transport_mode": "Ocean"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "shipments": [
      {
        "housebill_number": "HB7310452",
        "transport_mode": "Ocean Freight FCL",
        "origin": "Shanghai, CN",
        "destination": "Rotterdam, NL",
        "status": "In transit",
        "co2_footprint_kg": 1840.5
      }
    ],
    "count": 1
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## MyDHLi’s own options

DHL Global Forwarding publishes a Shipment Booking API that books Air and Ocean Freight shipments, and a Timestamp Notification Push API that reports their status. You request credentials with a form, DHL's Customer IT Solutions team approves them, and booking needs an eligible DHL Global Forwarding account number. Inside myDHLi, Reports can be scheduled.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Shipment Booking API | Books Air and Ocean Freight shipments and returns a DGF Booking ID, then the housebill number and shipment ID once the shipment is created. | An eligible DHL Global Forwarding shipper or consignee account number, an OAuth2 token and credentials approved after a verification form. |
| Timestamp Notification Push API | Sends status notifications to your own API endpoint for shipments created with the Shipment Booking API. | The same credentials as the Shipment Booking API. |
| Scheduled reports | Customizable reports on your shipment data, with filters, scheduled so you receive them automatically. | A myDHLi account. |
| myDHLi by hand | Quote + Book, Track, Documents, Analytics, Reports and customs data in the portal. | A username and password issued by DHL after you sign a customer contract. |

Read on November 12, 2026: [Shipment Booking (DHL Global Forwarding) API](https://developer.dhl.com/api-reference/dgf-shipment-booking), [Explore myDHLi](https://www.dhl.com/us-en/home/global-forwarding/mydhli/explore-mydhli.html), [myDHLi GoGreen customer flyer](https://www.dhl.com/content/dam/dhl/global/dhl-global-forwarding/documents/pdf/mydhli-gogreen-customer-flyer-en.pdf).

## Signing in to myDHLi

myDHLi signs you in at DHL Global Forwarding's own sign-in page with a username and password that DHL issues after you sign a customer contract, and your company decides which people get access. With Fous you sign in once through that page with your own account: the login is sealed with AES-256, never returned by the API or written to logs, and code and AI agents never see it.

## Worth knowing

- **Access comes with a customer contract**: DHL issues myDHLi usernames and passwords after a customer contract is signed. Without an account you can still get a quote in Quote + Book, but not Track, Documents or Reports.
- **Quotes are not binding, bookings are**: A quote in Quote + Book is a non-binding estimate. Selecting and booking a service submits a binding offer that the DHL affiliate accepts, so a method that books should run only on a quote someone has checked.
- **Quotes can be saved until they expire**: Quote + Book lets you save a quote and resume it during its validity, adding documents, references or remarks, or share it with a colleague, customer or supplier to continue.
- **The housebill number comes later**: Through the Shipment Booking API a booking first returns a DGF Booking ID. DHL recommends checking its status every 5 minutes; the housebill number and shipment ID arrive once the shipment is created.

## More in Logistics: forwarders, air cargo and customs

- [Extensiv 3PL Warehouse Manager](https://fous.com/automate/extensiv-3pl-warehouse-manager.md)
- [Air France KLM Martinair Cargo myCargo](https://fous.com/automate/air-france-klm-martinair-cargo-mycargo.md)
- [e-SkyCargo](https://fous.com/automate/e-skycargo.md)
- [Lufthansa Cargo eServices](https://fous.com/automate/lufthansa-cargo-eservices.md)
- [ACE Secure Data Portal](https://fous.com/automate/ace-secure-data-portal.md)
- [CARM Client Portal](https://fous.com/automate/carm-client-portal.md)
- [Dubai Trade](https://fous.com/automate/dubai-trade.md)
- [Customs Declaration Service](https://fous.com/automate/customs-declaration-service.md)
- [douane.gouv.fr](https://fous.com/automate/douane-gouv-fr.md)
- [ACE AESDirect](https://fous.com/automate/ace-aesdirect.md)
- [myDSV](https://fous.com/automate/mydsv.md)
- [myKN](https://fous.com/automate/mykn.md)
- [IPAFFS](https://fous.com/automate/ipaffs.md)
- [DGFT portal](https://fous.com/automate/dgft-portal.md)

Other industries: [Fidelity Plan Sponsor WebStation](/automate/fidelity-plan-sponsor-webstation), [ONE eCommerce](/automate/one-ecommerce), [NCR Power Traffic](/automate/ncr-power-traffic), [Mercedes-Benz Supplier Portal](/automate/mercedes-benz-supplier-portal), [Honeywell MyAerospace](/automate/honeywell-myaerospace), [ZooplaPro](/automate/zooplapro).

## Frequently asked questions

### Does myDHLi have an API?

DHL Global Forwarding publishes a Shipment Booking API and a Timestamp Notification Push API on DHL's developer portal, for booking and booking status. Credentials are requested with a verification form and approved by DHL's Customer IT Solutions team, and booking needs an eligible DHL Global Forwarding account number.

### Can I get a myDHLi quote without an account?

Yes. Quote + Book gives instant Air Freight and Ocean Freight FCL or LCL quotes with no account needed, compared by price, transit time and emissions. Tracking, documents and reports need a myDHLi account.

### Can myDHLi send me reports automatically?

Yes. Reports in myDHLi are customizable, with filters, and can be scheduled so you receive them automatically. With Fous, a workflow can also read Track or customs data on a schedule and post the result to your own system by webhook.

### What customs data does myDHLi show?

Import and export declarations down to the line item, including commodities, countries of origin, duties, taxes and key milestones, with dashboards on volumes, duties and taxes and clearance trends.

### Is Fous affiliated with DHL Global Forwarding?

No. Fous is an independent product. You use it with your own myDHLi account, and a method reads and does only what that account can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of myDHLi (DHL Global Forwarding). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.