Skip to content
AGENTIC Data Mining
● Agg TOOL customs.bol LAST SYNC 2026-07-11T09:20:00Z

Bill of lading

Inbound ocean shipment manifests with consignee, shipper, HS code, and TEU volumes normalized across ports. Query a consignee’s inbound cadence or a lane’s aggregate flow.

Records

96M

Inbound manifests, consignee-normalized

History

12yrs

12 US ports on one schema

New records

~48,000/day

As CBP manifests release

Freshness

Daily

JSON · Aggregation · included in subscription

Volume figures are illustrative placeholders until the coverage audit publishes.

Query parameters

qstring

Free-text search over record fields

jurisdictionstring

State, county, agency, or venue code

since / untilISO date

Filing or event date window

limitnumber

Max records per response (default 25, max 500)

Shared parameters shown; the tool's full input schema is served by the MCP server at connection time.

Example call

Request · customs.bol
{
  "tool": "customs.bol",
  "params": {
    "q": "consignee inbound cadence",
    "since": "2026-06-01",
    "limit": 25
  }
}
Try in playground

Schema

Field Type Description
bol_nostringBill of lading number
consigneestringNormalized consignee
shipperstringNormalized shipper
hs_codestringHarmonized System code
teunumberTwenty-foot equivalent units
port_of_ladingstringOrigin port
port_of_unladingstringUS arrival port
arrived_atISO dateArrival date

Sample record

Sample · customs.bol
{
  "bol_no": "MSCUOC1234567",
  "consignee": "EXAMPLE RETAIL CORP",
  "shipper": "SHENZHEN EXAMPLE MFG",
  "hs_code": "8517.62",
  "teu": 4,
  "port_of_lading": "YANTIAN",
  "port_of_unlading": "LOS ANGELES, CA",
  "arrived_at": "2026-07-08"
}

Use it for

  • Consignee inbound volume vs. guidance
  • Lane-level flow shifts after tariff changes
  • Supplier discovery from shipper joins
● Agg Near-real-time

Port/vessel AIS

maritime.ais

Vessel positions, port calls, anchorage dwell, and berth congestion derived from AIS. Query by MMSI, port, vessel class, or arrival window.

~48,000 tracked vessels · major US ports

Included in subscription View dataset
◆ Gated Daily

Freight rates

freight.rates

Spot and contract freight pricing across trucking and ocean lanes. Sourced under license terms that require access review before querying.

Coverage shown after review

Access requires review View dataset