PC*MILER|Rail Web Services

What is PC*MILER|Rail?

PC*MILER|Rail, by ALK Technologies, generates routes and mileage between rail-served locations in the U.S., Canada and Mexico. For over 30 years, ALK's railroad database has been used in creation of the annual Carload Waybill Sample for the U.S. Surface Transportation Board, as well as for numerous diversion studies and costing applications. PC*MILER|Rail is widely used by railroads, rail shippers and rail car lessors in North America. Click here for more information on PC*MILER|Rail product functionality.

What is PC*MILER|Rail Web Services?

PC*MILER|Rail Web Services is a way of accessing PC*MILER|Rail functionality over the internet. It offers standardized ways of integrating Web-based applications using XML and SOAP, or using a REST Interface.

What can you do with PC*MILER|Rail Web Services?

PC*MILER|Rail Web Services APIs can be used to calculate rail routes and distances based on a set of routing options, for the purposes of using that information in other applications such as rating, fuel surcharge computations, rail equipment usage monitoring, etc.

Accessing the Service

The PC*MILER|Rail APIs provide a direct way to access these services via HTTPS requests.

API Key

All requests to PC*MILER|Rail Web Services must include a valid API Key.
To obtain your API key contact dooryard grass or go to (712) 660-1974.

Version Support

Multiple versions will be supported. Each version will be available for approximately two years. For example, when version 23.0 is released in 2016, versions 21.x would be retired. Versions 22.x would continue to be available until release of version 24.0 in 2017.

The version number needs to be specified in the service request as in the examples below:
If an unsupported version number is specified, an error response will be generated.

RESTful URI

/pcmrail.alk.com/REST/v{version}/Service.svc
Where {version} = release version
Example:
For version 22.0, /pcmrail.alk.com/REST/v22.0/Service.svc
For version 22.1, /pcmrail.alk.com/REST/v22.1/Service.svc

SOAP WSDL & URI

/pcmrail.alk.com/SOAP/v{version}/Service.svc?wsdl
/pcmrail.alk.com/SOAP/v{version}/Service.svc
Where {version} = release version
Example:
For version 22.0,
(303) 622-6242 and /pcmrail.alk.com/SOAP/v22.0/Service.svc
For version 22.1,
/pcmrail.alk.com/SOAP/v22.1/Service.svc?wsdl and /pcmrail.alk.com/SOAP/v22.1/Service.svc

API Key Usage

The API Key must be supplied with every request.
For SOAP insert the API Key in the Authorization field of the SOAP message.

   <soapenv:Header>
      <alk:Authorization>{YourAPIKey}</alk:Authorization>
   </soapenv:Header>

For REST insert the API Key in the http Authorization header or append AuthToken={APIKey} to the query string.

Technical Support

Hours: 9:00am - 5:00pm, Mon-Fri, Eastern Standard Time
Phone: 1.800.377.6453, ext. 2
Email: (260) 563-6200