This Help Center is a preview of a future release. The final Help Center will be available on the Validation date.
Type = API Reference,; Topic = Multienterprise Information Network Tower (MINT), Transforms,;Persona = TraceLink Administrator, User, Solution Partner,; Orchestration = Manufacturing, Commerce,; Function = Supply Chain, IT, Procurement,
Customs status information transactions
Customs Status Information (EDI 350) is a standardized Electronic Data Interchange (EDI) transaction used by Customs Services to communicate the processing and clearance status of import and export shipments. Custom authorities exchange this transaction with authorized trading partners, including importers, exporters, customs brokers and custom agents, terminal operators, carriers, and service providers.
The transaction provides updates throughout the customs clearance process. Customs authorities generate an EDI 350 transaction whenever the customs status of a shipment changes. A shipment can receive multiple EDI 350 transactions as customs processing continues. Customs Status Information communicates shipment statuses such as:
-
Cargo release
-
Cargo hold
-
Inspection
-
Other customs dispositions
The transaction uses standardized EDI segments and data elements to exchange customs status information between customs, transportation, and supply chain management systems. This standardized structure enables consistent communication between trading partners regardless of their internal applications. Using Customs Status Information helps organizations:
-
Receive timely updates on customs processing activities.
-
Reduce manual communication and data entry errors.
-
Improve data accuracy through standardized electronic messaging.
-
Monitor shipment status with near real-time visibility.
-
Respond quickly to customs actions.
-
Coordinate transportation, terminal, and warehouse operations.
-
Support regulatory compliance.
-
Minimize shipment delays.
-
Improve supply chain visibility and operational efficiency.
Customs Status Information (X12)
The Customs Status Information X12 format communicates customs processing and clearance status updates for import and export shipments between customs authorities and authorized supply chain partners.
Contact your TraceLink Services representative for more information about integrating with this message.
Message Type: MPC_CUSTOMS_STATUS_INFORMATION
Transform Names:
B2B_EDI_X12_350_CustomsStatusInformation_IB_V1
B2B_EDI_X12_350_CustomsStatusInformation_OB_V1
| Input Element | Occurs | Length | Description | Example | ||||
|---|---|---|---|---|---|---|---|---|
| ISA | 1…1 | - | ISA interchange envelope. | - | ||||
| ISA01 | 1…1 | 2/2 | Qualifier for authorization control number in ISA02. Valid values:
| 00 | ||||
| ISA02 | 1…1 | 10/10 | Information used for additional identification or authorization of the interchange sender or the data in the interchange/ 10 spaces a valid entry. | - | ||||
| ISA03 | 1…1 | 2/2 | Qualifier for security information in ISA04. Valid values:
| 00 | ||||
| ISA04 | 1…1 | 10/10 | Identifies security information about the interchange sender or data. | - | ||||
| ISA05 | 1…1 | 2/2 | Interchange sender partner ID qualifier.
| 07 | ||||
| ISA06 | 1…1 | 15/15 | EDI sender ID mapping to file control header and to ServiceLinkId. | 7777776067344 | ||||
| ISA07 | 1…1 | 2/2 | Interchange receiver partner ID qualifier.
| 07 | ||||
| ISA08 | 1…1 | 15/15 | EDI receiver ID mapping to file control header. | 888888404358877 | ||||
| ISA09 | 1…1 | 6/6 | Interchange date in 6 char YYMMDD format. | 231020 | ||||
| ISA10 | 1…1 | 4/4 | Interchange time in 4 char HHMM format. | 1420 | ||||
| ISA11 | 1…1 | 1/1 | Repetition separator. Delimiter that separates repeated occurrences of a data element or composite data structure. Must be different than the data element separator, component separator, and segment terminator. | : | ||||
| ISA12 | 1…1 | 5/5 | Interchange control version number. Valid value = “00401” | 00501 | ||||
| ISA13 | 1…1 | 9/9 | Interchange Control Number for file control header. | 0000000000619827 | ||||
| ISA14 | 1…1 | 1/1 | Interchange level acknowledgment requested. Valid values:
| 0 | ||||
| ISA15 | 1…1 | 1/1 | Indicates whether the interchange is for production, test, or information purposes. Valid values:
| P | ||||
| ISA16 | 1…1 | 1/1 | Component element separator. Delimiter that separates data elements within a composite data structure. Must be different than the data element separator and segment terminator. | > | ||||
| GS | 1…1 | - | GS group functional envelope. Child of ISA. Only one GS group expected per interchange. | - | ||||
| GS01 | 1…1 | 2/2 | GS group function code. Valid value:
| AU | ||||
| GS02 | 1…1 | 2/15 | Application Sender's Code. | 2222224043588 | ||||
| GS03 | 1…1 | 2/15 | Application Receiver's Code. | TRACELINK | ||||
| GS04 | 1…1 | 8/8 | Current date stamp in 8 char X12 date format YYYYMMDD. | 231020 | ||||
| GS05 | 1…1 | 4/8 | Current time stamp in 6 char X12 time format HHMMSS. | 142000 | ||||
| GS06 | 1…1 | 1/9 | Group Control ID Number. | 619827 | ||||
| GS07 | 1…1 | 1/2 | Responsible Agency Code. Valid value = X. | X | ||||
| GS08 | 1…1 | 1/12 | X12 message version code. | 005010 | ||||
| ST | 1…* | - | ST transaction set envelope. Child of GS group. Only one ST transaction expected. | - | ||||
| ST01 | 1…1 | 3/3 | Transaction set identifier code. | 860 | ||||
| ST02 | 1…1 | 4/9 | Transaction set ID number. Counter for each ST segment beginning with 1. | 1 | ||||
| M10 | 1…1 | - | Manifest Identifying Information. Note: US CBP uses the IATA Cargo-XML standard for cargo release and status updates to carriers for air cargo. | - | ||||
| M1001 | 1…1 | 2/4 | Standard Alpha Carrier Code (SCAC) a 2-4 character code that identifies transportation carriers that ship goods across the US border. Primarily for motor carriers, but required for all carriers, regardless of transpoirt mode, By US Customs and Border Protection. Typically needs to be renewed every year. | ABC5 | ||||
| M1002 | 1…1 | 1/2 | Transportation method code identifying the type of transport used for the shipment.
| J | ||||
| M1003 | 1…1 | 2/3 | Country code. | US | ||||
| M1004 | 0…1 | 1/8 | Ocean vessel identifier. | 1X8508BCA | ||||
| M1005 | 0…1 | 2/28 |
| The Jolly Roger QEWY4875692 | ||||
| M1006 | 0…1 | 2/10 |
| 1X8508BCA 20261210 | ||||
| M1007 | 0…1 | 1/50 | Ocean or rail shipment manifest identifier mapping to oceanRailManifest. Required for transport method SEA, optioanl for RAIL, if available. If not available for SEA or RAIL, or equal to "000001", generate manifest identifier with date time stamp YYYMMDDHHMMSSNNN. | 8888752255225 | ||||
| M1009 | 0…1 | 1/1 | Code identifying the type of manifest for the shipment in Customs. Pass thru value. US CBP always uses "Z". | Z | ||||
| M1010 | 0…1 | 1/1 | Vessel code type. Valid values:
| L | ||||
| M1012 | 0…* | 1/50 | Shipment manifest identifier for transport method TRUCK mapping to truckManifest, if available. If not available and transport method = truck, generate manifest identifier with date time stamp YYYMMDDHHMMSSNNN. | 8888752255225 | ||||
| M1013 | 1….1 | 2/2 | Transaction set purpose code. Not mapped. | 00 | ||||
| M1014 | 0…1 | 2/2 | Application Type Code. Pass thru mapping.
| 28 | ||||
| P4 | 0…20 | - | Port Information. Transmit identifying information for a port. US CBP generates only one P4 loop for transport method TRUCK. | - | ||||
| P401 | 1…1 | 1/30 | Port location identifier using CBP Port Codes (Census Schedule D) in the US and UN/ECE Recommendation No. 16: UN/LOCODE in the rest of the world. Pass thru mapping. | 87859652 | ||||
| P402 | 1…1 | 8/8 | Estimated date time of arrival in X12 date format YYYYMMDD. | 20261210 | ||||
| P403 | 0…1 | 1/15 | Quantity. Number of BOLs in manifest. Explicit decimal. | - | ||||
| P404 | 1…1 | 1/1 | The next port of call for a vessel after the port identified in P401. in departure from the U destination. From the last port of call prior to departure from the US, this is the first foreign port of destination. Pass thru mapping.
| 12493 | ||||
| P405 | 0…1 | 4/8 | Estimated time of arrival in 24-hour clock time in X12 time formats HHMM or HHMMSS or HHMMSSDD (DD = decimal seconds in tenths and hundredths). | 11445966 | ||||
| V9 | 0…20 | - | Event details. | - | ||||
| V901 | 1…1 | 3/3 | Code to specify type of the ocean shipment event.
| REQ | ||||
| V902 | 0…1 | 1/25 | Freeform description of event. | - | ||||
| V903 | 0…1 | 8/8 | Event date in date format YYYYMMDD. | 20261210 | ||||
| V904 | 0…1 | 4/8 | Time of event in 24-hour clock time in X12 time formats HHMM or HHMMSS or HHMMSSDD (DD = decimal seconds in tenths and hundredths). | 11445900 | ||||
| VEH | 0…10 | - | Conveyance identification information. Motor transport only. | - | ||||
| VEH01 | 0…1 | 1/6 | Assigned number used for differentiation within a transaction set. | - | ||||
| VEH02 | 1…1 | 1/30 | Unique vehicle identification number stamped on the vehicle by the manufacturer. | VIN998444323 | ||||
| VEH09 | 0…1 | 1/80 | Equipment reference identifier number for the vehicle. | 12356987458 | ||||
| VEH17 | 0…1 | 2/3 | Code identifying the country of the vehicle owner(s) | US | ||||
| VEH20 | 0…1 | 2/2 | Equipment description code identifying the type of equipment used, based on US CBP Export Manifest, Appendix F, Equipment Type Code. Valid values:
| CN | ||||
| VEH21 | 0…1 | 1/80 | Transaction reference identifier value as defined by enum in VEH22. | 0025842575 | ||||
| VEH22 | 0…1 | 2/3 | Transaction reference type for X12 segments REF and N9 and EDIFACT RFF for general reference data that is not a transaction document identifier.
| BT | ||||
| VEH23 | 0…1 | 1/1 | Load or empty status code. Valid values:
| L | ||||
| VEH24 | 0…1 | 1/80 | Transponder number of vehicle. Only used for motor transport. | NY | ||||
| VEH25 | 0…1 | 1/80 | US Department of Transport identifier number. Only used for motor transport. | X358GK974LO55474 | ||||
| VEH26 | 0…1 | 1/3 | State, province, region, or other subdivision code for the owner(s) of the vehicle. | 587425952587P | ||||
| NM1 | 0…9999 | - | Individual or organizational name information | - | ||||
| NM101 | 1…1 | 2/3 | Partner entity type defines the partner type in the group.
| CL | ||||
| NM102 | 1…1 | 1/1 | Entity type for the individual or organization related to the cargo under inspection. Valid values :
| 4 | ||||
| NM103 | 0…1 | 1/60 | Individual's last name or name of the organization. | Freddie | ||||
| NM104 | 0…1 | 1/35 | Individual's first name. | The | ||||
| NM105 | 0…1 | 1/25 | Individual's middle name or initial. | Freeloader | ||||
| NM108 | 0…1 | 1/22 | Identifier type for the individual or organization. Valid values:
| UL | ||||
| NM109 | 0…1 | 2/80 | Identifier value for entity defined in NM108. | 00587459652 | ||||
| VID | 0…9999 | - | Conveyance identification information. Equipment. | - | ||||
| VID01 | 1…1 | 2/2 | Equipment description code identifying the type of equipment used, based on US CBP Export Manifest, Appendix F, Equipment Type Code. Valid values: - BR = Barge - BX = Boxcar - CN = Ccontainer - TL = Trailer - VE = Vessel, ship | CN | ||||
| VID02 | 0…1 | 1/4 | Equipment Initial. Prefix or alphabetic part of an equipment unit's identifying number. | 0034 | ||||
| VID03 | 1…1 | 1/15 | Equipment identifier number. Sequencing or serial part of an equipment unit's identifying number (pure numeric form for equipment number is preferred). | 12356987458 | ||||
| VID06 | 0…1 | 4/5 | Length of the equipment used in shipment. | 23 | ||||
| VID07 | 0…1 | 1/8 | Height of the equipment used in shipment. | 10 | ||||
| VID08 | 0…1 | 1/8 | Width of the equipment used in shipment. | 10 | ||||
| VID10 | 0…1 | 1/1 | Load or empty status code. Valid values:
| L | ||||
| VID11 | 0…1 | 2/2 | Type of transportation service code. Used by US CBP for ocean transport. Valid values:
| 02 | ||||
| VID13 | 0…1 | 2/4 | Standard Alpha Carrier Code (SCAC) a 2-4 character code that identifies transportation carriers that ship goods across the US border. In this position, the SCAC is for the lessor, the owner of the equipment. | FDXE | ||||
| VID14 | 0…1 | 1/80 | License plate number for the vehicle or equipment. | 587963 | ||||
| VID16 | 0…1 | 2/3 | Country code for equipment. | US | ||||
| VID17 | 0…1 | 1/80 | Automated Commercial Environment (ACE) identifier for the equipment recorded in VID03 | 458792 | ||||
| VID18 | 0…1 | 1/3 | State, province, region, or other country subdivision code for the owner(s) of the equipment. | NY | ||||
| M7 | 0…5 | - | Seal numbers associated with the equipment and conveyance. Used by US CBP for the USA-Canada in-transit program for rail. Also used for ocean transport. | - | ||||
| M701 | 1…1 | 2/15 | Unique number on seal used to close a shipment. | 00123458796587426587 | ||||
| M702 | 0…1 | 2/15 | Unique number on seal used to close a shipment. | - | ||||
| M703 | 0…1 | 2/15 | Unique number on seal used to close a shipment. | - | ||||
| M704 | 0…1 | 2/15 | Unique number on seal used to close a shipment. | - | ||||
| M7A | 0…22 | - | Original seal numbers on equipment to be replaced ny a new seal number. Used by US CBP for the USA-Canada in-transit program for rail. Also used for ocean transport. | - | ||||
| M7A01 | 0…1 | 2/15 | Original seal number to be replaced. | 00123458796587426587 | ||||
| M7A02 | 0…1 | 2/15 | Replacement seal number. | 00214458796587426995 | ||||
| M7A03 | 0…1 | 8/8 | Date seal number is changed or replaced in X12 date format YYYYMMDD. | 20261210 | ||||
| M7A04 | 0…1 | 2/3 | Entity identifier code. Only used for transport method rail. Valid values:
| G7 | ||||
| M7A05 | 0…1 | 1/60 | Free form name. | Freddie | ||||
| M7A06 | 0…1 | 1/80 | Free form description. | Freddie's Freeload | ||||
| M7A07 | 0…1 | 1/3 | Code indicating a location on a piece of equipment, as observed from the rear-end. The rear-end of the equipment is based on the equipment type (i.e. container door, chassis wheels, brakes.) (missing or bad snippet) | LF | ||||
| K1 | 0…4 | - | Free form remarks relevant to customs inspection status within P4 port information loop | - | ||||
| K101 | 0…1 | 1/30 | Free form information. | - | ||||
| K102 | 0…1 | 1/30 | Free form information. | - | ||||
| X4 | 0…9999 | - | Customs release information. | - | ||||
| X401 | 0…1 | 1/50 | Bill of Lading/Waybill identifier assigned to the shipment by the carrier or consolidator. Must be same unique number sent on the M1110 in transaction set 309. | 1587964258325 | ||||
| X402 | 0…1 | 1/15 | Quantity. May represent a partial release of product quantity from the BOL. Does not necessarily equal the full quantity in the BOL. | 125.23 | ||||
| X403 | 0…1 | 2/3 | Customs entry code defining the type of entry assigned by U.S. Customs. Pass thru mapping. | XYZ | ||||
| X404 | 0…1 | 1/50 | Entry number assigned by a Customs agency. Automated Commercial System code furnished by U.S Customs Service. | 6783252589 | ||||
| X405 | 0…1 | 8/8 | Date of posting by customs service. | 20261210 | ||||
| X406 | 0…1 | 4/8 | Time of posting by customs service. | 11445900 | ||||
| X407 | 0…1 | 2/3 | Bill of lading disposition code advising the carrier or port authority about BOL postings. Pass thru mapping. | 203 | ||||
| X408 | 0…1 | 1/50 | House bill number: 12 character identifier that includes the Bill of Lading or the Waybill Numbers. Identification number assigned to the shipment by the carrier or consolidator. Must be same unique number sent on the M1111 in transaction set 309. | 897526544778921 | ||||
| X409 | 0…1 | 2/4 | Standard Alpha Carrier Code (SCAC) for the carrier that issued the Bill of Lading. Must be the same code as the SCAC in M1112 in transaction set 309. X401+X409 is the full simple/regular/master (shipment control) number. | 5847226954 | ||||
| X410 | 0…1 | 2/4 | Standard Alpha Carrier Code (SCAC) for the carrier that issued the House Bill number (Bill of Lading/Waybill). Must be the same code as the SCAC in M1112 in transaction set 309. X401+X409 is the full simple/regular/master (shipment control) number. | 58962487514514 | ||||
| X411 | 0…1 | 1/4 | Equipment Initial. Prefix or alphabetic part of an equipment unit's identifying number. Rail and ocean transport. | 0034 | ||||
| X412 | 0…1 | 1/15 | Equipment identifier number. Sequencing or serial part of an equipment unit's identifying number (pure numeric form for equipment number is preferred). Rail and ocean transport. | 12356987458 | ||||
| X413 | 0…1 | 1/30 | Location identifier for the port of transaction or entry. | 1001 | ||||
| X414 | 0…1 | 1/30 | Location code used to identify a permit to transfer. US CBP FIRMS facility code. | E226 | ||||
| X415 | 0…1 | 2/3 | Transaction reference type for X12 segments REF and N9 and EDIFACT RFF for general reference data that is not a transaction document identifier.
| 8S | ||||
| X416 | 0…1 | 1/80 | Transaction reference identifier value as defined by enum in transactionReferenceType. | 0025842575 | ||||
| X418 | 0…1 | 1/30 | US CBP inbond destination US port using a Census Schedule D code. Truck only. Pass thru mapping. | 1001 | ||||
| X419 | 0…1 | 1/30 | US CBP inbond destination US port using a Census Schedule K code for truck. Foreign port of destination for ocean and rail. Pass thru mapping. | 12493 | ||||
| K1 | 0…4 | - | Free form remarks relevant to customs release information within X4 loop. | - | ||||
| K101 | 0…1 | 1/30 | Free form information. | - | ||||
| K102 | 0…1 | 1/30 | Free form information. | - | ||||
| N9 | 0…999 | - | Extended reference information. For truck imports, segment is used by US CBP and CBSA (Canada Borders Services Agency) as part of the US-Canada In-transit program. For Ocean and Rail this segment will only be populated if the data is sent to US CBP, in the 309 or other IB transaction from the carrier/consolidator to the customs service. | - | ||||
| N901 | 0…1 | 2/3 | Transaction reference type for X12 segments REF and N9 and EDIFACT RFF for any kind of reference data.
| ANI | ||||
| N902 | 0…1 | 1/80 | Transaction reference identifier value as defined by enum in transactionReferenceType. | 8196733288 | ||||
| N7 | 0…999 | - | Equipment details. Used for Ocean and Rail only. | - | ||||
| N701 | 0…1 | 1/4 | Equipment Initial. Prefix or alphabetic part of an equipment unit's identifying number. | 0034 | ||||
| N702 | 0…1 | 1/15 | Equipment identifier number. Sequencing or serial part of an equipment unit's identifying number (pure numeric form for equipment number is preferred). | 12356987458 | ||||
| SE | 1…1 | - | ST … SE transaction set trailer envelope. Child of GS group. Only one ST transaction expected. | - | ||||
| SE01 | 1…1 | 1/10 | Total count of segments in ST … SE transaction set including ST and SE segments. | - | ||||
| SE02 | 1…1 | 4/9 | Transaction set control number. | - | ||||
| GE | 1…1 | - | GS … GE functional group trailer envelope. Child of ISA interchange. Only one GS group expected. | - | ||||
| GE01 | 1…1 | 1/6 | Number of transaction sets in functional group. | - | ||||
| GE02 | 1…1 | 1/9 | Functional group control number. | - | ||||
| IEA | 1…1 | - | ISA … IEA interchange control trailer envelope. Only one interchange expected per transmission. | - | ||||
| IEA01 | 1…1 | 1/5 | Number of functional groups in interchange. | - | ||||
| IEA02 | 1…1 | 9/9 | Interchange control number. | - | ||||
ISA*06*authorizat*01*securityIn*07*6278032738213 *07*3520075644994 *251020*1420*<*00501*000619827*0*P*>~
GS*AU*2222224043588*TRACELINK*20251020*142000*619827*X*005010~
ST*350*0001~
M10*ABC5*R*US*1X8508BC*The Jolly Roger*20261212*000001**Z*L***00*28~
P4*1001*20261210*403*12493*1144~
V9*REQ*V902*20261210*114459~
VEH*01*VIN998444323*******12356987458********US***CN*0025842575*VN*L*NY*X358GK974LO55474*87P~
NM1*CA*4*Freeloader*Freddie*The***UL*00587459652~
VID*BX*0035*12356987459***2300*10*10**E*BB**FDXE*587964**US*458793*NY~
M7*58796587426587*58796587426588*58796587426589*58796587426580~
M7A*458796587426587*458796587426587*20261210*G7*Freddie*Freddie's Freeload*LF~
K1*Text1*Text2~
X4*1587964258325*125.23*XYZ*6783252589*20261210*114459*203*897526544778921*6954*4514*0034*12356987458*1001*E226*MA*0025842575**1001*12493~
K1*Text3*Text4~
N9*AN*8196733288~
N7*0034*12356987458~
SE*65*0001~
GE*1*619827~
IEA*1*000619827~
Tag end


