Bulk Data Formats

Bulk data feeds are delivered as CSV files which customers can pull from our FTP server or we can push to your sFTP server. Customers then integrate the bulk data into their TMS or other IT system so that the schedule data displays directly in the company system, alleviating the need to search elsewhere for data.

Our data feeds are available in a variety of formats, each providing a specific view for a particular use case. Additionally, Linescape can tailor-make a data feed to to fit specific needs.

Operational Vessel Schedules

These vessel schedules are in a Port Rotation Format and a basic file consists of the following data fields:

Data FieldDescription
carrier_codeCarrier SCAC Code
carrier_nameCarrier Name
service_codeService/Route Code
service_nameService/Route Name
vessel_imoVessel IMO Number
vessel_nameVessel Name
vessel_voyageVessel Voyage Number
port_codePort UN Locode
port_namePort Name
port_etaPort ETA Date
port_etdPort ETD Date
portcalls_sequenceSequence of Port Calls
portcalls_totalTotal Number of Port Calls
timestamp_scheduleDate/Time a specific schedule was last updated
timestamp_carrierDate/Time the carrier last sent a batch update

The data file is organized as one port call per record. For example, a vessel voyage which comprises 8 ports of call will be displayed in 8 records, with the portcalls_sequence indicating the chronological order of calls, from 1 to 8. To search for a particular schedule, customers search on the unique combination of Carrier-Service-Vessel-Voyage, which would return all 8 records of the schedule.

Each schedule has two timestamps. One is the date/time that each schedule was last updated. The other is the date/time that the carrier last sent a complete set of updated schedules. If the former timestamp becomes much older than the latter, then that schedule becomes a cancelled or blanked schedule and is filtered out of the data feed.

Enhancements:

The data fields listed above are included in a basic subscription. Premium data fields are also available and may include: actual ATA/ATD dates/times from AIS, port Cut-Off dates/times, port Terminal names/codes such as FIRMS or SMDG, vessel Operator, vessel Call Sign, vessel Flag, vessel MMSI, vessel TEU.

Origin-Destination Schedules

These port pair schedules are in a Commercial Schedule format and a basic file consists of the following data fields:

Data FieldDescription
c1scacCarrier #1 SCAC
r1nameRoute #1 Name
v1nameVessel #1 Name
s1voyVoyage #1 Label
oportOrigin Port Locode
oetdOrigin Port ETD
ts1portTranship Port #1 Locode
ts1etaTranship Port #1 ETA
omodeOrigin Mode (S=”Ship”, T=”Tranship”)
c2scacCarrier #2 SCAC
r2nameRoute #2 Name
v2nameVessel #2 Name
s2voyVoyage #2 Label
ts1etdTranship Port #1 ETD
ts2portTranship Port #2 Locode
ts2etaTranship Port #2 ETA
c3scacCarrier #3 SCAC
r3nameRoute #3 Name
v3nameVessel #3 Name
s3voyVoyage #3 Label
ts2etdTranship Port #2 ETD
dportDestination Port Locode
detaDestination Port ETA
dmodeDestination Mode (S=”Ship”, T=”Tranship”)
cscacBooking Carrier
durDuration (days)

It is organized as one origin-destination per record. Each record may comprise either a single direct vessel voyage, or two vessel voyages with one transhipment, or three vessel voyages with two transhipments. Each of the three possible vessels may be deep-sea vessels or the first and/or last vessels may be feeder vessels.

Enhancements:

The data fields listed above are included in a basic subscription. Premium data fields are also available and may include: port Cut-Off dates/times, port Terminal names/codes such as FIRMS or SMDG, vessel Operator, vessel Call Sign, vessel Flag, vessel MMSI, vessel TEU.

Vessel Register Data

Vessel data can be delivered and associated with either of the schedule data feeds. The most commonly requested information consists of the following data fields:

Data FieldDescription
nameVessel Name
imoVessel IMO Number
flagFlag Country
call_signCall Sign
mmsiMMSI Number
ownerVessel Owner
operatorVessel Operator
old_namesPrevious Names
gross_tonnageGross Tonnage
net_tonnageNet Tonnage
dwtDeadweight Tons
max_teuNominal Container Capacity
avg_teu14mt Container Capacity
reefer_teuReefer Container Capacity
ship_typeShip Type
port_ofPort of Registry
yearYear Built

Vessel register data is cross-checked and updated regularly.

Enhancements:

The data fields listed above are included in a basic subscription. Premium data fields are also available and may include: Shipyard, Hull, Gear, Length, Beam, Draft, Engine Make, Engine Type, Power, Speed.

Shopping Cart
Scroll to Top