CAPE Portal Explained: How CBP's Refund System Works

What CAPE Stands For

CAPE stands for Customs Automated Processing Environment. The name is CBP's branding for the new IEEPA refund module it built inside ACE. Despite the new acronym, CAPE is not a separate system — it is a workflow and data submission path within the ACE portal that importers already use for entry filing, duty payment, and drawback claims.

CBP developed CAPE under the March 12, 2026 Court of International Trade order, which required the agency to establish a refund mechanism within 39 days. The agency met that deadline when the portal went live on April 20, 2026, though early reports noted technical limitations, particularly around the 9,999-entry-per- declaration cap and ACH configuration requirements.

ACE Portal Prerequisites

Before you can use CAPE, you need the following in place:

• ACE account: An active account in CBP's Automated Commercial Environment at ace.cbp.dhs.gov. If you've filed customs entries in the past decade, your customs broker almost certainly has ACE access. Direct importers should have their own accounts.
• Importer of Record access: Your IOR number (typically your EIN or a CBP-assigned number) must be linked to your ACE account. You must be the IOR of record on the entries you're claiming.
• Customs Power of Attorney (if using a broker): If a licensed customs broker is filing on your behalf, a current POA must be on file with CBP. Most brokers already have this for their existing clients.
• ACH banking profile: A direct deposit account for refund disbursement, set up under your IOR number in ACE. This is separate from ACH accounts you may have for duty payment.

ACH Banking Setup

The ACH (Automated Clearing House) banking profile is the most common stumbling block for new CAPE filers. CBP will not issue refunds by paper check — all IEEPA refunds are disbursed via ACH direct deposit. If your ACE account doesn't have an ACH profile for your IOR number, you need to add one before filing.

To add an ACH profile: log into ACE, navigate to your account settings, select "Refund/Drawback ACH," and add your bank routing number and account number. CBP typically processes new ACH registrations within 3-5 business days. Do not file your CAPE claim until the ACH profile is confirmed — a claim submitted without a valid ACH profile will sit in a pending state until banking information is resolved, potentially delaying your refund.

The CSV Declaration Format

CAPE submissions use a structured CSV file — not a web form with individual fields. You prepare the CSV outside the portal (in Excel, Google Sheets, or programmatically) and upload it as a single file. The required columns, in order, are:

CBP's published template includes a header row with these exact column names. The portal will reject files where the header row doesn't match exactly, including differences in capitalization or spacing.

The 9,999-Entry-Per-Declaration Limit

Each CAPE declaration can contain a maximum of 9,999 entry lines. This is a hard technical limit in the current CAPE implementation. Importers with more than 9,999 affected entry lines — common among large e-commerce companies, major retailers, and high-volume manufacturers — must split their filing across multiple declarations.

There is currently no stated limit on the total number of declarations per IOR, and there is no advantage to submitting everything in a single declaration if you're under the limit. CBP processes declarations in the order received.

What Happens After Submission

After you upload your CSV, CAPE generates a submission confirmation number. Save this — it's your reference for tracking the status of your claim. CBP's automated system then performs an initial format check within 24 to 72 hours. If the file has format errors, you'll receive a rejection notice via ACE messages with specific error codes.

If the file passes the initial format check, it enters the processing queue where CBP cross-references your entry lines against its own records. This is where the 60-to-90-day timeline begins. During this period, you can check status through the CAPE dashboard in ACE.

Once CBP completes its review, it issues a notice of reliquidation or liquidation for each approved entry. The reliquidation notice triggers the refund calculation, and ACH disbursement follows within approximately two weeks.

Reported Issues at Launch

Several trade publications reported technical difficulties during the first week of CAPE's operation. The most widely noted issues included:

• ACH validation delays: Some importers with recently-added ACH profiles found their filings stalling in a validation queue, with CBP's system unable to confirm banking information in real time. CBP indicated this is being addressed.
• Portal loading issues: High demand on launch day (April 20) resulted in intermittent slowdowns for ACE access generally, not specific to CAPE. Most were resolved within 48 hours.
• CSV rejection for whitespace: Multiple filers reported rejection due to invisible trailing whitespace characters in their CSV files, particularly files exported from Excel on Windows. The fix is to save CSVs as plain UTF-8 without BOM encoding.

These issues were reported by outlets including NerdWallet, CBS News, and NewsNation within the first week of the portal's operation. CBP has not issued a formal patch notice but has confirmed it is aware of the ACH validation delay.

When to Consider Working with a Partner

Self-filing CAPE makes sense if you have a small number of entries, a clean ACE record, and a customs compliance team comfortable with CBP's systems. For most mid-size to large importers, the combination of complex IOR situations, large entry volumes, and the CSV formatting precision required makes professional help worth considering.

Recovery partners bring existing ACE infrastructure, experience with the CAPE CSV format, and — in many cases — established relationships with CBP's trade compliance teams that can help resolve processing delays. They typically work on contingency (a percentage of the recovered amount), so the upfront risk to the importer is zero.