Security Filing - JSON Specification

Summary

Use this format to send or receive security filings like ISF.
NameDescription
RootThe top level document
SecurityFilingAn individual security filing.
ContainerA container used to ship goods
AddressA physical location.
OrganizationAn organization associated to this filing.
ISFLineAn representation of a ISF Lines
NameData TypeDescriptionRequired
doc_typeStringAlways security_filing_json
security_filingsArray<SecurityFiling>Array of security filings
versionStringThe version of the specification being used.
NameData TypeDescriptionRequired
containersArray<Container>Containers associated with the filing.
etaDateTimeEstimated port arrival date for the shipment.
etdDateTimeEstimated departure date for the shipment.
house_billStringThe house bill of lading number
isf_linesArray<ISFLine>Products within the shipment associated to the filing.
master_billStringThe master bill of lading associated with the house bill
ocean_billStringThe ocean bill of lading number used for straight or simple bills of lading
organizationsArray<Organization>Organizations associated with the filing.
po_numberStringThe purchase order number associated to the filing.
reference_numberStringThe shipper reference number associated to the filing.
shipment_typeStringShipment type associated to the filing.
vessel_nameStringThe vessel name for the shipment.
voyage_numberStringThe voyage number for the shipment.
NameData TypeDescriptionRequired
container_numberStringIdentifying container number (including SCAC prefix)
container_typeStringISO 6346 container type code (like 20GP)
NameData TypeDescriptionRequired
address_1StringThe first line of the address.
address_2StringThe second line of the address.
cityStringThe city.
countryStringThe 2-Digit ISO 3166 Alpha-2 Country Code. Like 'US'
postal_codeStringThe postal or ZIP code.
stateStringThe state, province, or administrative division code
NameData TypeDescriptionRequired
addressAddressThe address of the organization.
company_nameStringThe name of the organization.
typeStringOrganization type. Valid types are: importer, seller, buyer, consignee, ship_to, cntr_stuffing_location, and consolidator
NameData TypeDescriptionRequired
country_of_originStringThe 2-letter ISO code of the country of origin for the product.
hts_numberStringThe product's primary harmonized tariff code.
manufacturerAddressThe manufacturer of the product represented by the line.
part_descriptionStringA description of the product.
part_numberStringThe part number used to identify the product.

Example