CustomsGenius
← All Publications
News

Disposition Codes: How ACE Cargo Release Status Messages Work

Published: November 3, 2026  ·  8 min read
Disposition Codes: How ACE Cargo Release Status Messages Work
Photo: Bilal Ahmed / Pexels

Key Points

On this page

  1. At a glance
  2. Where do disposition codes come from?
  3. When do disposition codes arrive in the entry lifecycle?
  4. How are disposition codes transmitted and read?
  5. Common disposition codes errors and what they cost
  6. How do disposition codes interact with related ACE terms?
  7. Frequently asked questions
  8. What importers and brokers should do
  9. Key references

Disposition codes are the ACE cargo release status codes CBP sends in ABI status notifications to describe what has happened to a cargo release or entry: released, held, documents required, PGA action, or canceled. Customs brokers and carriers read them to decide whether cargo can physically move, and they sit at the release stage of the entry lifecycle, after the cargo release and the manifest match and before entry summary review and liquidation. They are not entry summary status, liquidation status, or ISF status.

This reference reflects ACE practice as of November 2026. The links in this article go to the primary documents: the CBP CATAIR publications and official program pages themselves. Read the source.

At a glance

Where do disposition codes come from?

Disposition codes come from CBP's ACE Cargo Release processing and are published in the ACE ABI CATAIR cargo release status notification chapter and the ACE Cargo Release Glossary. ACE Cargo Release is the ACE transaction, successor to the paper CBP Form 3461 and the ACS Simplified Entry, through which the broker transmits the data CBP needs to decide release of cargo before or on arrival; it is the transaction that returns disposition messages and holds. For background on how that release data is built and sent, see our guide to ACE Cargo Release transmission.

The code tables themselves sit alongside other ABI code lists. CATAIR Appendix B, Valid Codes, is the ACE ABI CATAIR appendix listing code values used across ABI transactions, including status and disposition codes; our CATAIR Appendix B reference explains how to navigate it. Because CBP revises the CATAIR, treat the published chapter as the only source for current disposition codes and their exact wording.

When do disposition codes arrive in the entry lifecycle?

Disposition codes first arrive once ACE matches the cargo release to the carrier's manifest, and further disposition codes can follow at any point until the cargo leaves CBP control. ACE sends status messages to both the filer and the carrier, so each party sees the same decision from its own side.

Release dispositions

A release disposition tells the carrier and terminal that CBP has released the entry. Disposition code 1C means CBP has released the entry; it is the message brokers, carriers and terminals wait for before moving freight. A 1C release is not a final determination of admissibility or duty, and it is not PGA clearance by itself.

Holds, documents required and PGA actions

Other disposition codes signal that CBP needs documents, has placed a hold, or has canceled a release. PGA dispositions, such as may proceed or hold intact, arrive on the same ABI channel. A shipment can therefore carry a CBP release and an open PGA hold at the same time, and the cargo should not move until every applicable disposition allows it. Confirm the specific code values for each of these outcomes in the CATAIR rather than relying on memory.

How are disposition codes transmitted and read?

Disposition codes are transmitted electronically through ABI as cargo release status notifications, and the broker's software translates each code into a release, hold, or action prompt for the user. Carriers receive parallel messages through their own ACE connection and use them to decide whether to hand freight over.

In practice, a broker's screen may show a friendly label rather than the raw code. Staff should know how their software maps disposition codes to labels and where to view the underlying message and its timestamp. When software behavior, message delivery, or certification questions arise, the filer's ABI client representative, the CBP Office of Trade contact assigned to each ABI filer, handles connectivity, testing and production issues; see our article on the ABI client rep.

Common disposition codes errors and what they cost

Misreading disposition codes is one of the most common causes of freight moving when it should not, or sitting when it could move. The recurring errors are:

The consequences range from demurrage and storage charges while cargo waits, to enforcement exposure when held cargo is moved without authorization. Confirm penalty and liquidated damages exposure with your broker or CBP for the specific situation.

How do disposition codes interact with related ACE terms?

Disposition codes govern physical release only, so they interact with several neighboring ACE processes without replacing them.

Frequently asked questions

Does a 1C disposition mean my goods are cleared for good?

No. Among disposition codes, 1C means CBP has released the entry, but it is not a final determination of admissibility or duty and does not by itself clear any PGA hold.

Are disposition codes the same as entry summary status?

No. Disposition codes describe cargo release events; entry summary status, liquidation status and ISF status are separate messages with separate meanings.

Where can I find the full list of disposition codes?

The authoritative list of disposition codes is in the ACE ABI CATAIR cargo release status notification chapter and the ACE Cargo Release Glossary, published on cbp.gov.

Can disposition codes change after release?

Yes. CBP or a PGA can send later disposition codes, including an intensive-exam disposition, so filers and carriers should keep monitoring until the cargo leaves CBP control.

What importers and brokers should do

Key references


Working through tariffs on real entries? Create an account, then see plans for the full toolkit.

About the Author

Franz Brotzen, CustomsGenius CEO & Founder. Franz is a published researcher on U.S. trade policy. He has worked at think tanks in Washington DC and Tokyo, where his academic publications focussed on tariffs and legal compliance. Franz received his JD from Harvard Law School.

Request Beta Access

Get early access to CustomsGenius and start recovering IEEPA refunds faster.

Beta Pilot Ongoing