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.
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 waybill/bill of lading information for a given equipment.
- Retrieve Waybill (Trial) - Retrieve current waybill/bill of lading information for requested equipment for waybills created in Trial by the Submit Bill of Lading service. ***For BETA testers only***
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.