FAQ

Historical data is included with your subscription. Simply pass the start and end date to retrieve historical data.

Rack, Padd, and Terminal/Supplier endpoints have historical data going back to 01/01/2017.

The Demand API supports paging, so if a request is made that results in 20,000 records, this data will be broken up by 5,000 per page. This is accomplished by using limit/offset or page/pageSize. Choose only one otherwise a 400 bad request error will occur if both limit/offset and page/pageSize are submitted on the same

The max number of records per page is 5,000 records. Request 5,000 records by entering limit = 5,000 or pageSize = 5,000.

If the request made to the API does not have a limit or pageSize configured, the default is 200 records.

A supplier leaving TABS would result in a drop in market coverage. Also, it would impact terminal/supplier counts and overall demand we report.

A new supplier on TABS increases our market coverage of BOLs and as a result increases our demand coverage. New supplier volumes are included in Demand as soon as we start receiving BOLs.

If DTN does not receive any lifting information for the rack/grade combination, it is omitted from the API results rather than returning a 0.

We first determine what the BOL average is by grade at the state level. Next, we take the BOL average and multiple that by the number of liftings for the grade for the rack location. Example – For the Month of May 2022 Cedar City has less than 3 suppliers for #2 Diesel. As a

DTN requires that a rack/grade combination must have 3 or more suppliers to reveal unaltered lifting figures. This is done to protect supplier anonymity. If the rack/grade combination has less than 3 suppliers, a rack average is calculated and output to SumNetVolume. The RackAverage field will display as Y for RackAverage and N if it