The Gen-Disp Format


This format will provide you data which tracks each update in our system. It can be sent via sftp (ssh), FTP, email, etc, or it can be picked up from our FTP or sftp server. It can be sent either hourly (when data is available) or daily. Once you are ready to begin receiving data in this format, please send email to specifying that you want to receive the gen-disp format, give us the email address to which you want it sent (or the details we'll need for one of the other methods), and let us know the schedule (hourly or daily) on which you want us to generate the data.

File Format:

The file uses standard CSV (comma-separated values) format.

    Field                         Max Size    Notes
    ============================  ========    ===============
    Our shipment identifier             10
    IBC's HAWB                          11    only digits
    Customer reference                  11
    Full HAWB                           40
    Shipment creation date              10    YYYYMMDD
    US port of entry                     3    if appropriate
    Event code date               10    YYYYMMDD
    Event code time                4    HHMM in the event's local time zone
    Event code                     2    disposition code list
    Event code description        63


For a list of event codes and their meanings see our event code list.

Sample Data:

Here is a sample data file.