Catalog
We have developed several API's to enhance your business's experience with us. Therefore, we are providing you with a list of our current API offerings to help you select the services that are right for you.
RESTful Web Service Methods
- GET - request data from BNSF
 - POST - send data to BNSF
 - PUT - update records
 - DELETE - delete records
 
Tracing
AUTOMOTIVE
- POST VINS - Returns tracing details for requested VINS, up to 300 at a time.
 - Trip Plan - Returns list of significant events planned for a VIN from origin to destination.
 - VIN Details - Returns detailed information about your VIN shipments.
 - VIN Inspections - Returns detailed information about inspections of your VIN shipments.
 
CARLOAD
- Cars - Returns tracing details for all railcars on the BNSF network, with a default page size of 2,000.
 - POST Cars - Returns tracing details for requested cars, up to 300 at a time.
 - Carload Consist - Returns tracing details for all railcars on U, J, C, E, G and X unit trains.
 - Trip Plan - Returns list of significant events planned for a railcar equipment initial and number from origin to destination.
 
INTERMODAL
- Trip Plan - Returns list of significant events planned for an intermodal equipment initial and number from origin to destination.
 - Units - Returns tracing details for all units on the BNSF network, with a default page size of 2,000.
 - POST Units - Returns tracing details for requested units, up to 300 at a time.
 
TRAINS
- Ag Trains - Provides current status, with tracing details for up to 25 Ag trains.
 - Coal Trains - Provides current status, with tracing details for up to 25 Coal trains.
 - Trains - Provides current status, with tracing details for all unit train types.
 - POST IP Trains - Provides current status, with tracing details up to 25 industrial products unit trains.
 
Automotive Hub Operations
- Haul Away Gate Entry Request - Allow truckers and/or dispatchers to submit load details prior to an actual ingate for an automotive haul away move.
 - AddHold Request - Haulway or OEM will have the capability to add hold on VIN at Origin or Destination ("O" or "D")
 - Release Hold Request - This enables Haulway and OEM to release existing Hold on a VIN.
 - Haulway Carries - Retrieves information of a entry request that is already posted.
 
Intermodal Hub Operations
- Dray open booking details
 - Driver Vehicle Inspection Report - Submit chassis defects (Y/N) within BNSF intermodal hubs.
 - Removes dray plan
 - Flips - Returns details on authorized flips for given units.
 - Hub - Returns a list of valid lot locations at a given hub facility.
 - Ingate - Returns way-billed units that can be registered prior to arrival at a hub facility.
 - Current Gate Target - Returns all ingate targets related to the authorized list of 633s.
 - Validate Ingate - Returns required/missing information needed for ingate.
 - J1 Receipts - Returns a list of J1 Gate Receipts.
 - Outgate - Returns way-billed units that can be registered prior to exiting at a hub facility.
 - Validate Outgate - Returns required/missing information needed for outgate.
 - Pickup Number - Validate and/or retrieve pickup numbers.
 - Pre-Ingate - Advanced creation of an ingate ahead of arriving at a hub facility.
 - Cancel a pre-ingate.
 - Pre-Outgate - Advanced creation of an outgate ahead of exiting a hub facility.
 - Cancel a pre-outgate.
 - Street En-route - Report pre-arrival to hub and returns rail waybill ingate completeness check and missing elements (if any).
 - Unit Details - Returns hub information (e.g., Lot Location) for units at a BNSF Facility (Equivalent to DLL on bnsf.com).
 - Domestic Empties - Returns a list of empty units ready for pickup at a BNSF facility.
 - Update Parking - Update a unit's parking information at a Hub facility (i.e. Lot, Row, Spot).
 
Prices/Rates
- Carload Rates - Returns a list of prices within a BNSF Carload Price Authority.
 - Intermodal Rates - Returns a list of prices within a BNSF Intermodal Price Authority.
 - Invoices - Retrieve Open Invoices - Returns details of customer's open invoices for given Patron code of customer.
 
Schedules
- Intermodal Schedules - Returns all Intermodal Schedules.
 
Waybill Management
- Submit Bill of Lading - Submit required transit information in order to create a waybill/bill of lading (BOL).
 - Retrieve Waybill - Retrieve current active waybill/bill of lading information for a given equipment.
 
Reference Files
- Event Codes - Returns a list of event codes and their descriptions, which describe equipment activity.
 - Stations - Returns details of each station matching input criteria.
 - STCC - Returns STCC numbers and descriptions matching input criteria.
 - STCC - Hazardous - Returns detailed information on hazardous materials matching input criteria.
 - Umler - The Umler service returns internal and external dimensions, capacities, weight information, and other specific characteristics of freight cars and intermodal trailers and containers.
 
Diagnostics
- Health Check - Check the status of the BNSF Customer API
 - Analytic Event - Submit event data for analytical purposes.
 
API Support
Monday – Friday, 8 am – 5 pm (Central Time)
                    For additional help, visit our API Support page.
                    
