API Docs

Overview Authentication Bill Detail Custom Data Filter Company Detail Shipping Records Shipping Statistics

BillOfLadingData.com – API Documentation

This documentation provides access to global Bill of Lading shipping records, import/export metadata, company insights, and structured global customs datasets.

Authentication

All requests require:

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

1. Bill Detail API

POST /api/billdetail

Returns full Bill of Lading–level structured shipment details.

Request Example

{
  "pageNo": 1,
  "pageSize": 10,
  "searchKey": "",
  "country": "US",
  "startDate": "2024-01-01",
  "endDate": "2024-12-31"
}

curl -X POST https://api.billofladingdata.com/api/billdetail \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "pageNo":1,
        "pageSize":10
      }'

const fetch = require("node-fetch");

fetch("https://api.billofladingdata.com/api/billdetail", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    pageNo: 1,
    pageSize: 10
  })
})
.then(r => r.json())
.then(console.log);

import requests

url = "https://api.billofladingdata.com/api/billdetail"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}

payload = {"pageNo":1, "pageSize":10}
r = requests.post(url, json=payload, headers=headers)
print(r.json())

Short Sample Response

{
  "code": 200,
  "msg": "success",
  "data": {
    "total": 54231,
    "records": [
      {
        "bill_of_lading_nbr": "ABC123",
        "importer_name": "STEADYGO LIMITED",
        "exporter_name": "BEYOGLU CIKOLATA SAN TIC A.S",
        "hs_code": "180632",
        "product_desc": "CHOCOLATE PRODUCTS",
        "start_port": "ISTANBUL",
        "end_port": "HONG KONG",
        "vessel": "MSC ORION",
        "voyage": "127E",
        "container": "TCLU8282999",
        "gross_weight": "1579 KG",
        "actual_arrival_date": "2024-10-12"
      }
    ]
  }
}
📦 View Full Practical Response (150+ structured fields) 
{
  "bill_of_lading_nbr": "ABC123",
  "master_house_bill_indicator": "H",
  "manifest_no": "MAN998812",
  "vessel": "MSC ORION",
  "voyage": "127E",
  "vessel_country_code": "TR",

  "importer_name": "STEADYGO LIMITED",
  "importer_id": "IMP99812",
  "importer_country": "HK",
  "importer_city": "HONG KONG",
  "importer_address_full": "RM 2308 23/F HO KING COMM CTR 2-16 FAYUEN ST MONGKOK KL",
  "importer_tel": "+852 2345 6789",

  "exporter_name": "BEYOGLU CIKOLATA SAN TIC A.S",
  "exporter_id": "EXP772812",
  "export_country": "TR",
  "exporter_city": "ISTANBUL",
  "exporter_address": "ISTANBUL ORGANIZE SANAYI BOLGESI NO 221 TURKEY",

  "hs_code": "180632",  
  "hs_code_desc": "Chocolate products",  
  "product_desc": "Milk chocolate with pistachio",  
  "brand": "BEYOGLU",
  "variety": "KADAYIFLI",
  "t1_category_en": "Food",
  "t2_category_en": "Confectionery",
  "t3_category_en": "Chocolate",
  "t4_category_en": "Processed chocolate",

  "start_port": "ISTANBUL",
  "end_port": "HONG KONG",
  "foreign_port": "IST",
  "place_of_receipt": "ISTANBUL",
  "place_of_delivery": "HONG KONG",
  "transport_type": "SEA",
  "shipment_mode": "SEA",

  "container": "TCLU8282999",
  "container_type": "40' HC",
  "seal_1": "SEAL99212",
  "teu": 2,

  "manifest_qty": 144,
  "manifest_units": "CTN",
  "piece_count": 14400,
  "packages": 144,
  "packages_desc": "CARTONS",

  "gross_weight": "1579 KG",
  "net_weight": "1500 KG",
  "measurement": "2.1 CBM",
  "weight_unit": "KG",

  "invoice_value": 22800.00,
  "invoice_value_foreign_currency": "USD",
  "cif": 24120.00,
  "fob": 21500.00,
  "total_value_usd": 24120.00,
  "statistics_value_usd": 23980.00,
  "duty_usd": 1240.55,

  "customs_office_code": "HK001",
  "customs_procedure": "IM4",
  "customs_value": 24120,
  "be_number": "BE202411220001",
  "declaration_type": "IMPORT",
  "assessment_date": "2024-10-13",
  "clearance_status": "CLEARED",
  "actual_arrival_date": "2024-10-12",

  "transport_doc": "BL-ABC123",
  "transport_doc_number": "BL-ABC123",
  "transport_doc_date": "2024-09-18",

  "agent": "SF EXPRESS",
  "agent_address": "Tsing Yi Logistics Center HK",

  "origin_country": "TR",
  "origin_place": "ISTANBUL",
  "country_origin": "TR",

  "system_date": "2024-10-12",
  "year": "2024",
  "month": "10"
}

2. Custom Data Filter API

POST /api/customdata/filter

Short Response

{
  "code": 200,
  "msg": "success",
  "results": 551,
  "filters_used": {
    "hsCode": "200989",
    "keyword": "acerola"
  }
}

3. Company Detail API

POST /api/company/detail

Short Response

{
 "companyName": "STEADYGO LIMITED",
 "total_shipments": 88,
 "top_suppliers": [
    "Beyoglu Cikolata",
    "Sutas Dairy"
 ],
 "top_hs_codes": [
    "180632",
    "040221"
 ]
}

4. Shipping Records API

POST /api/shipping/records

Short Response

{
 "records": [
   {
     "bill_of_lading_nbr": "ABC123",
     "importer_name": "STEADYGO LIMITED",
     "hs_code": "180632",
     "gross_weight": "1579 KG",
     "start_port": "IST",
     "end_port": "HKG"
   }
 ]
}

5. Shipping Statistics API

POST /api/shipping/statistics

Short Response

{
 "country": "CN",
 "hs_code": "180632",
 "year_range": "2020-2025",
 "total_shipments": 5512,
 "total_importers": 221,
 "total_exporters": 331
}

© BillOfLadingData.com – A Digital Media Solutions AU Pty Ltd Platform