BNSF API Center | Catalog

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.