Check Filing Required

GET/v1/aes/filing-required$0.05 per call

Quick check if EEI filing is required based on destination country, value, and license type.

Parameters

Name	In	Type	Description
destinationoptional	query	string	ISO-2 destination country
valueoptional	query	number	Shipment value in USD
licenseTypeoptional	query	string	AES license type code

Response fields

Field	Type	Description
success	boolean	e.g. `true`
data	object
data.destination	string	e.g. `CN`
data.value	number	e.g. `5000`
data.licenseType	string	e.g. `C30`
data.filingRequired	boolean	e.g. `true`
data.reason	string	e.g. `Value $5,000 exceeds $2,500 threshold per Schedule B number.`
data.threshold	number	e.g. `2500`
data.regulation	string	e.g. `15 CFR 30.2(a)(1)`
meta	object
meta.dataSource	object
meta.dataSource.name	string	e.g. `ComplianceGrid`
meta.dataSource.provenance	string	e.g. `computed`

Fields are read from a real response captured 2026-11-04. Optional fields may be absent in other responses.

Errors

400 invalid request
401 missing or bad key
403 not in your plan
429 rate limited, see Retry-After
402 payment required
5xx retry with backoff

Error bodies and codes are described in Error codes and troubleshooting.

curl "https://api.compliancegrid.ai/v1/aes/filing-required?destination=CN&value=5000" \
  -H "Authorization: Bearer $CG_API_KEY"

Try it in the sandbox

Runs against sandbox.api.compliancegrid.ai with your own sandbox key, which stays in this browser. Sandbox responses are mock data. Get a free key.

Sandbox key

Remember for this tab

destination (query)

value (query)

licenseType (query)

Example response · captured from production 2026-11-04

{
  "success": true,
  "data": {
    "destination": "CN",
    "value": 5000,
    "licenseType": "C30",
    "filingRequired": true,
    "reason": "Value $5,000 exceeds $2,500 threshold per Schedule B number.",
    "threshold": 2500,
    "regulation": "15 CFR 30.2(a)(1)"
  },
  "meta": {
    "dataSource": {
      "name": "ComplianceGrid",
      "provenance": "computed"
    }
  }
}