Get your Destin8 clearance status through an API

What you can build on Destin8

• Check import clearance by UCN

  Build this

  Looks up one UCN in the INQ enquiry and reads whether it is cleared, its release note and any government hold.

  Takes

  UCN

  Returns

  UCN, unit ID, bill of lading, vessel, clearance date, release note, hold details, manifest status

• Track a container's status

  Build this

  Reads a container's record in the TRX enquiry: vessel arrival, landed or loaded status, customs clearance and in-gated or out-gated status.

  Takes

  Unit ID

  Returns

  Unit ID, vessel, expected arrival, actual arrival, landed or loaded, customs clearance status, in-gated, out-gated

• List voyages at a working port

  Build this

  Searches the VNQ voyage enquiry by working port, date range and vessel name, and reads each voyage and whether it is inventory linked.

  Takes

  Working port, date range, vessel name (optional)

  Returns

  Vessel name, voyage, working port, estimated arrival, inventory linked

• Self-nominate an import consignment

  Build this

  Claims an import record with the CSN transaction using its unit ID and bill of lading, so the UCN is associated with your badge.

  Takes

  Badge, unit ID, bill of lading

  Returns

  UCN, unit ID, bill of lading, result or error code

Automate Destin8 with a workflow

A workflow 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 UCNs still waiting for clearance or release

  Build this

  Starts

  Every weekday at 7:00

  Step 1

  For each UCN on your list, check import clearance in INQ.

  Step 2

  Keep the UCNs with no clearance date or a release note other than Yes.

  Step 3

  Email you the list with the release note and hold details of each.

• Container status changes, posted to your system

  Build this

  Starts

  Every hour

  Step 1

  For each container on your list, track its status in TRX.

  Step 2

  Keep the containers whose landed, clearance or out-gated status changed since the last run.

  Step 3

  Post each change to your transport system's webhook.

• New voyages due at your port in the next 7 days

  Build this

  Starts

  Every day at 6:00

  Step 1

  List the voyages at your working port for the next 7 days in VNQ.

  Step 2

  Keep the voyages that were not there on the last run.

  Step 3

  Email you the vessel names, estimated arrivals and inventory linked flag.

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, it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Check import clearance by UCN” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "www.destin8.co.uk/check_import_clearance",
    "input": {
      "ucn": "GBFXT26AC0001234"
    }
  }'

{
  "status": "completed",
  "data": {
    "ucn": "GBFXT26AC0001234",
    "unit_id": "ACMU1234567",
    "bill_of_lading": "NWLN26110457",
    "vessel": "Globex Horizon",
    "clearance_date": "2026-11-11",
    "release_note": "No - See Hold Details",
    "hold_details": [
      {
        "authority": "Port Health",
        "status": "Hold"
      }
    ],
    "manifest_status": "Frozen"
  }
}

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.

Destin8’s own options

MCP offers machine interfaces for Destin8 subscribers: EDIFACT messages by email or SFTP, and Inter System Link messages through its free Destin8Visual.ISL software. Software vendors get specifications for a Customs Declaration API and Notification APIs, which pass declarations to HMRC's CDS. Enquiries such as INQ and TRX are on screen.

Read on November 12, 2026: Electronic Messaging, Software Vendor Guides, Destin8 Information Pack 2026.

Signing in to Destin8

Destin8 signs you in with your user ID and password. When your access is not validated against a registered or static IP address, it also asks for three random characters of your memorable text. With Fous you sign in through Destin8's own sign-in with your own account, the login is sealed with AES-256, and a method sees only the records your badge can.

Worth knowing

Your badge decides what you can see

Every Destin8 company has a 3-letter badge code, and records can be viewed only by a badge associated with them. A badge not registered at a port gets error 60332, and each port community is a separate subscription.

Self-nominate before you clear

An inventory linked import has a UCN. You claim it with CSN using the unit ID and bill of lading, then enter the UCN in your declaration's Master UCR field. Exports are claimed with ESN and the UCR added with EDU.

Statuses come from the parties

MCP does not update records itself: the terminal operator records arrival and out-turn, the shipping line creates UCNs. Some lines upload the manifest only after the vessel closes at the port of origin.

Frozen is normal

A manifest status of Frozen only means the vessel has arrived. A release note of No - See Hold Details means a government body hold, and a plain No on a 12-digit UCN means other groupage splits have not cleared.

More in Logistics: ocean carriers, terminals and ports

• myDCLI
• PayCargo
• APM Terminals TERMPoint
• Georgia Ports WebAccess
• 易港通
• INTTRA
• CMA CGM eBusiness
• COSCO SHIPPING Lines eBusiness
• Maersk.com
• myMSC
• ONE eCommerce
• ShipmentLink
• eModal
• PortTruckPass
• DAKOSY
• Portbase
• PierPASS
• Forecast by Tideworks
• 1-Stop Vehicle Booking System

Other industries: TIMOCOM, Daimler Truck Supplier Portal, ClassNK Customer Hub, Yardi Voyager, LeadsOnline, 1WorldSync Item Management.