Skip to main content
POST

Authorizations

Authorization
string
header
required

Use a Terminal49 API key in the Authorization header with the Token prefix.

Authorization: Token YOUR_API_KEY

Body

application/json
bol_number
string
required

Master (SCAC-prefixed) or house bill of lading number. Spaces and hyphens are removed and letters uppercased before matching.

Required string length: 4 - 40
Example:

"MEDUW9559867"

months
integer
default:12

How many months back to search.

Required range: 1 <= x <= 18

Response

OK

bol_number
string
required

The normalized bill of lading number that was looked up.

Example:

"MEDUW9559867"

found
boolean
required

false when no import under this number is on record in the search window.

searched_since
string<date>
required

Start of the search window.

Example:

"2025-10-01"

bills_matched
integer

Distinct bill of lading records matched (at most 50).

bills_truncated
boolean

true when more than 50 records matched and only the most recent 50 are used.

containers
object[]

Containers on the matched bills (at most 200).

containers_truncated
boolean

true when more than 200 containers exist and only the first 200 are returned.

commodities
object[]

Commodity lines on the matched bills, grouped by bill with the highest estimated value first within each bill. At most 200 lines are returned; the cap keeps the first 200 in that order, not the 200 highest-value lines overall.

commodities_truncated
boolean

true when more than 200 commodity lines exist and only the first 200 are returned.