Skip to content
FIRMSapi Docs

Look up a code

Terminal window
curl https://api.firmsapi.com/v1/firms/E430 -H "x-api-key: $FIRMSAPI_KEY"
{
  "data": {
    "code": "E430",
    "name": "MAHER TERMINAL",
    "status": "active",
    "type": { "code": "03", "label": "Pier or terminal" },
    "address": { "street": "4010 Port Elizabeth", "city": "Elizabeth", "state": "NJ", "zip": "07201" },
    "port": { "code": "4601", "name": "Newark/Elizabeth" },
    "region": "2",
    "location": { "lat": 40.6807, "lon": -74.1497, "quality": "PointAddress" },
    "junk": false,
    "first_seen": "2026-10-23",
    "last_changed": "2026-10-23",
    "same_address": [],
    "warnings": []
  },
  "meta": { "data_as_of": "2026-10-23", "source": "U.S. Customs and Border Protection (CBP) FIRMS code list", "mode": "live" }
}
  • The code is case-insensitive. It must be four letters or digits, otherwise you get 400 invalid_request (not counted).
  • A code that is not on the list returns 404 not_found, which counts as a call.
  • Deleted codes return 200 with status: "deleted" and a warning. Placeholders (“DO NOT USE”) and CBP test records return junk: true and a warning: never file with them.
  • same_address lists the other codes registered at the same street address, city, state and ZIP.
  • location is null when the address could not be geocoded.

Facility types

Section titled “Facility types”
type.code Label
01 Container freight station (CFS)
02 Foreign trade zone (FTZ)
03 Pier or terminal
04 Bonded warehouse
05 Inspection facility
06 Importer premises
07 DP site
08 CBP administrative
09 Centralized examination station (CES)
10 Rail or air terminal (our inference; CBP does not label it)
11 CBP test (always junk: true)

type is null when CBP left it blank.