openapi: 3.1.0
info:
title: BNSF Customer Diagnostics Reference Files API
description: 'BNSF Railway customer-facing API platform covering shipment tracing, hub
operations, prices, schedules, waybill management, reference files, and
diagnostics. All requests require certificate-based mutual authentication
(mTLS) using approved client certificates. Only endpoints explicitly
surfaced in BNSF''s public Developer''s Console documentation are described
below; the full catalog is exposed to authenticated customers through the
same base URL.
'
version: 1.0.0
contact:
name: BNSF API Support
url: https://www.bnsf.com/ship-with-bnsf/support-services/customer-api/
servers:
- url: https://api.bnsf.com:6443
description: Production
- url: https://api-trial.bnsf.com:6443
description: Trial
security:
- MutualTLS: []
tags:
- name: Reference Files
paths:
/v1/cars:
get:
operationId: getCars
summary: Retrieve car reference data
description: 'Sample endpoint documented in the BNSF API Postman quickstart, returning
reference data about railcars in the customer''s scope.
'
tags:
- Reference Files
responses:
'200':
description: Car reference data
components:
securitySchemes:
MutualTLS:
type: mutualTLS
description: 'BNSF customer APIs require certificate-based mutual TLS using a client
certificate (PEM) issued by an approved Certificate Authority.
'