AES/EEI filing via API

10 min read Updated February 18, 2026

What Is AES Filing?

The Automated Export System (AES) is the US government's system for collecting Electronic Export Information (EEI). Most exports from the US valued over $2,500 per Schedule B number, or requiring an export license, must be filed via AES.

Filing Requirements

An AES filing is required when: - Shipment value exceeds $2,500 per Schedule B number - The commodity requires an export license - The shipment is destined for certain embargoed countries - The shipment contains controlled items regardless of value

Creating a Filing

bash

curl -X POST https://api.compliancegrid.ai/v1/aes/filings \
  -H "Authorization: Bearer $CG_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "exporterEIN": "12-3456789",
    "usppiName": "Acme Exports Inc",
    "consignee": {
      "name": "European Imports GmbH",
      "country": "DE",
      "address": "123 Hauptstrasse, Berlin"
    },
    "commodities": [{
      "scheduleBNumber": "8471.30.0100",
      "description": "Laptop computers",
      "quantity": 100,
      "value": 150000,
      "eccn": "EAR99",
      "exportLicenseType": "NLR"
    }],
    "transportMode": "ocean",
    "portOfExport": "4601",
    "dateOfExport": "2026-03-15"
  }'

Filing Status

After submission, the filing moves through these states:

DRAFT — Created but not submitted
SUBMITTED — Sent to AES
ACCEPTED — Received ITN (Internal Transaction Number)
REJECTED — Contains errors; see rejection codes in the response
AMENDED — Successfully updated after initial acceptance

Retrieving the ITN

The ITN is your proof of filing and must appear on shipping documents:

bash

curl -H "Authorization: Bearer $CG_TOKEN" \
  "https://api.compliancegrid.ai/v1/aes/filings/FILING_ID"

Common Rejection Codes

AES-001 — Invalid Schedule B number
AES-002 — Missing or invalid EIN
AES-003 — Value exceeds license exemption threshold without license
AES-004 — Invalid port of export code

Was this article helpful?