AES Filing
Record an exporter's authorization
POST
/v1/aes/authorizations$0.05 per callRecords the written authorization or power of attorney by which an exporter (USPPI) lets ComplianceGrid file EEI as its authorized agent (15 CFR 30.3). It starts as pending_review; our team checks the signed document and activates it. Managed filings for that exporter's EIN need an active, in-date authorization. Dates are YYYY-MM-DD.
Send an Idempotency-Key header to retry safely.
Request body
| Field | Type | Description |
|---|---|---|
| usppiEinrequired | string | The exporter's EIN, for example 12-3456789 |
| usppiNamerequired | string | max length 200 |
| kindrequired | string | one of "power_of_attorney", "written_authorization" |
| signedByrequired | string | max length 200 |
| signedByTitleoptional | string | max length 200 |
| signedAtrequired | string | format date |
| effectiveFromrequired | string | format date |
| effectiveTooptional | string | Leave out for no end date format date |
| documentReferencerequired | string | Where the signed document is kept or how you sent it to us. We keep the record for five years from the export (15 CFR 30.10). min length 3 · max length 500 |
Response fields
The spec does not describe this response yet, and there is no captured example. Run the request with your sandbox key to see its shape.
Errors
- 400 invalid request
- 401 missing or bad key
- 403 not in your plan
- 429 rate limited, see Retry-After
- 402 payment required
- 409 conflict or not ready
- 5xx retry with backoff
Error bodies and codes are described in Error codes and troubleshooting.