AES Filing API

const API = "https://api.compliancegrid.ai";
const headers = { "x-api-key": process.env.CG_API_KEY!, "Content-Type": "application/json" };
const get = (path: string) => fetch(API + path, { headers }).then((r) => r.json());
const post = (path: string, body: unknown) => fetch(API + path, { method: "POST", headers, body: JSON.stringify(body) }).then((r) => r.json());

// Validate an EEI filing (the full schema is in the OpenAPI spec)
const result = await post("/v1/aes/validate", {
  usppi: {
    companyName: "Acme Electronics Inc.",
    ein: "12-3456789",
    address: { line1: "100 Export Blvd", city: "Los Angeles", state: "CA", zip: "90210" },
    contactName: "John Smith",
    phone: "310-555-0100",
  },
  ultimateConsignee: {
    companyName: "Berlin Tech GmbH",
    address: { line1: "Friedrichstr. 100", city: "Berlin", country: "DE" },
    type: "R",
  },
  portOfExport: "2704",
  portOfUnlading: "4101",
  countryOfUltimateDestination: "DE",
  modeOfTransport: "40",
  carrierIdentification: "LUFT",
  dateOfExport: "2026-11-15",
  relatedPartyTransaction: false,
  routedExportTransaction: false,
  hazardousMaterials: false,
  filingType: "predeparture",
  commodities: [{
    scheduleBNumber: "8471300100",
    description: "Laptop computers",
    quantity1: 10,
    unitOfMeasure1: "NO",
    shippingWeightKg: 25,
    value: 12000,
    exportInformationCode: "OS",
    licenseType: "C33",
    originState: "CA",
    dfIndicator: "D",
  }],
});

// A bad field is a 400 whose error.details names it; otherwise read valid and issues
if (result.success === false) console.error(result.error.message);
else console.log(result.data.valid, result.data.issues);

{
  "success": true,
  "data": {
    "id": "eei_val_364c33ec5d324b1f",
    "valid": true,
    "filingRequired": true,
    "filingRequiredReason": "One or more commodities exceed the $2,500 per Schedule B threshold (15 CFR 30.2(a)(1)(iv))",
    "totalErrors": 0,
    "totalWarnings": 1,
    "totalInfo": 1,
    "issues": [
      {
        "field": "commodities[0].licenseValue",
        "severity": "WARNING",
        "code": "LICENSE_VALUE_RECOMMENDED",
        "message": "License value should be provided when a license number is specified.",
        "regulation": "15 CFR 30.6(b)(23)"
      },
      {
        "field": "commodities[0].value",
        "severity": "INFO",
        "code": "EEI_FILING_REQUIRED",
        "message": "Commodity value ($75,000) exceeds the $2,500 threshold per Schedule B number. EEI filing is mandatory.",
        "regulation": "15 CFR 30.2(a)(1)(iv)"
      }
    ],
    "validatedAt": "2026-02-19T15:21:14.377Z"
  }
}