# Track your Dubai Trade cargo from your own systems

> Get the cargo status of a Mirsal II declaration, a bill of lading or an airway bill, and a container's details, from Dubai Trade with one API call each. Or have a workflow check every open declaration each morning and email you the ones whose status moved.

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

Works with your own Dubai Trade account. Fous is an independent product.

## What you can build on Dubai Trade

### Track cargo status by declaration number

Searches Mirsal II, Cargo Tracking, Track Cargo Status by declaration number and opens View Cargo Status for the summary of each document's status.

- Takes: Declaration number
- Returns: Declaration number, the status of each document in the summary, marked when not available or not applicable

### Track cargo by bill of lading or airway bill

Searches Track Cargo Status by bill of lading for inbound sea cargo, or by master airway bill for air cargo, and reads the status of each matching record.

- Takes: Channel (sea or air), bill of lading or master airway bill number, rotation number or house airway bill (optional)
- Returns: Bill of lading or airway bill number, each matching record shown (up to the top 10) with the status of each document in its summary

### Look up a container

Runs DP World's Container Enquiry for one container number and reads the container details it shows.

- Takes: Container number
- Returns: Container number, each container detail the enquiry shows

## Automate Dubai Trade 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.

### Open declarations whose cargo status moved

Starts: Every weekday at 8:00 Dubai time

1. For each open declaration number you list, track its cargo status by declaration number.
2. Keep the declarations whose document statuses changed since the last run.
3. Email you each one with its declaration number and the new statuses.

### Inbound bills of lading, sent to your forwarding system

Starts: When your system calls the workflow's webhook with a list of bills of lading

1. For each bill of lading in the list, track its cargo by bill of lading for inbound sea cargo.
2. Keep the bills whose document statuses changed since the last run.
3. Post each one, with its bill of lading and document statuses, to your webhook.

### Container check before the truck is booked

Starts: Every weekday at 7:00 Dubai time

1. For each container number you list, look up the container in Container Enquiry.
2. Keep the containers whose details changed since the last run.
3. Post the container number and its details to your transport system's 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 “Track cargo status by declaration number” 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": "eservices.dubaitrade.ae/track_cargo_status",
    "input": {
      "declaration_number": "101-20481736-26"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "declaration_number": "101-20481736-26",
    "documents": [
      {
        "document": "Declaration",
        "status": "Cleared"
      }
    ]
  }
}
```

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.

## Dubai Trade’s own options

Dubai Trade's own guides describe its services as screens and file uploads: declaration invoices and vehicles can be uploaded in a published file format, and manifests and courier declarations have upload services. Its public pages do not document a self-serve API for reading cargo or container status.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Invoice File Upload and Vehicle File Upload | Sends a declaration's invoice and vehicle lines as a file instead of keying them in. | Files in Dubai Customs' Declaration_Invoice_File_Upload_Format, v0.8 since the 1 November 2026 vehicle change. |
| Manifest and courier file uploads | Advance Cargo Information (Manifest File Upload, Status, Amend) and the Courier File Upload service for courier declarations. | A Dubai Trade account with those services added. Courier declarations need UAE Pass authentication. |
| Dubai Trade by hand | Over 700 e-services from Dubai Customs, DP World and other entities, including Cargo Tracking and Container Enquiry, one search at a time. | A Dubai Trade login, with each entity's services added to your account. |

Read on November 12, 2026: [Enhancement to vehicle information submission in customs declarations](https://www.dubaitrade.ae/en/news-announcements/dubai-customs/enhancement-to-vehicle-information-submission-in-customs-declarations), [Download Center: Cargo Clearance manuals](https://www.dubaitrade.ae/en/downloads/category/54-cargo-clearance), [UAE Pass authentication for declaration and claim submission](https://www.dubaitrade.ae/en/downloads/send/260-uae-pass/1598-uae-pass-authentication-for-declaration-and-claim-submission).

## Signing in to Dubai Trade

Dubai Trade signs you in with your Dubai Trade login, and you can link UAE Pass to that username and log in with it. Submitting a declaration or claim needs a UAE Pass login whose Emirates ID matches the company's Customs client profile. With Fous you sign in once through Dubai Trade's own sign-in with your own account: the login is sealed with AES-256 and code and AI agents never see it.

## Worth knowing

- **Declarations need a UAE Pass login**: UAE Pass authentication has replaced digital certificate validation for declarations and claims, on screen and through Courier File Upload. The Emirates ID behind the UAE Pass must match the Customs client profile.
- **You see only your own declarations**: Track Cargo Status shows the declarations that belong to the logged-in user. A bill of lading search with several matches shows the top 10 records.
- **Vehicle values follow the RTA list**: Since 1 November 2026, a vehicle declaration accepts only the brands, model names and color names on the RTA list. Invoice File Upload and Vehicle File Upload use the revised format v0.8.
- **Services are added to your account**: Dubai Trade groups services by entity, and its guides show adding each one, such as inspection, truck release or VCC services, to your account before you can use it.

## 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)
- [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)
- [myDHLi](https://fous.com/automate/mydhli.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: [Nest employer account](/automate/nest-employer-account), [CMA CGM eBusiness](/automate/cma-cgm-ebusiness), [MyCarrierPortal](/automate/mycarrierportal), [Covisint Supplier Portal](/automate/covisint-supplier-portal), [eGCA](/automate/egca), [Paragon MLS](/automate/paragon-mls).

## Frequently asked questions

### Does Dubai Trade have an API?

Not a self-serve one documented on its public pages. Dubai Trade's guides describe file uploads for declaration invoices and vehicles in a published format, and upload services for manifests and courier declarations. Cargo Tracking and Container Enquiry are screens you search one record at a time.

### How do I track cargo by bill of lading on Dubai Trade?

Open Mirsal II, Cargo Tracking, Track Cargo Status and search by Bill of Lading / Airway Bill Number. For sea cargo you choose Inbound (Import), enter the bill of lading and an optional rotation number. For air cargo you enter the master airway bill and an optional house airway bill.

### Why can't I submit a declaration after logging in with my password?

Because declarations and claims now need a UAE Pass login. The Emirates ID linked to that UAE Pass must match the Customs client profile, or the submission does not go through.

### Can I submit passenger declarations online?

Yes, since November 2026. You submit them through Dubai Trade with Passenger as the Cargo Channel and the correct Port of Loading or Port of Discharge. The physical documents are still presented at the terminal.

### Is Fous affiliated with Dubai Trade?

No. Fous is an independent product. You use it with your own Dubai Trade 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 Dubai Trade (Dubai Trade). 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.