Skip to content

FIRMSapi docs

FIRMSapi is a REST API for U.S. Customs and Border Protection FIRMS codes, the 4-character codes that identify piers, container freight stations (CFS), bonded warehouses, foreign trade zones (FTZ) and exam sites. Its core job is catching a wrong FIRMS code before ACE rejects the filing. It answers four questions:

Can I file with it?

Pre-filing validation against the port and intended use, with the ACE reject each check prevents and a list of what still needs checking in ACE.

What is this code?

Look up any code, active or deleted, with address, facility type, port and status.

Which code is this place?

Fuzzy search and autocomplete over names, addresses and aliases.

What's near here?

Facilities near a latitude and longitude, filtered by type.

Get a key from the developer portal. Questions or a missing code? Every code also has a public page at firmsapi.com/codes.