LCL Status Integration API

Connect Your Systems to myEuropacific

Push shipment data, receive status updates, and automate your logistics workflow with our REST API.

Quick Start

Get your API key from myEuropacific team

Include the key in X-API-Key header

Start pushing shipment data via POST

Base URL

https://myeuropacific.com/api/api/lcl-status

Authentication

All API requests must include the X-API-Key header with your API key.

curl -X POST "https://myeuropacific.com/api/api/lcl-status/shipments" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{ ... }'

API Endpoints

Notify myEuropacific about a new shipment. The system will automatically match by HBL number or add to review queue if no match is found.

Request Body

{
  "hbl_number": "HBL2024001",          // Required - House BL number
  "mbl_number": "MBL2024001",          // Optional - Master BL number
  "booking_number": "BK123456",        // Optional
  
  "origin_port": "CNSHA",              // Required - Port code
  "origin_port_name": "Shanghai",      // Optional
  "destination_port": "SIKOP",         // Required - Port code (Koper)
  "destination_port_name": "Koper",    // Optional
  
  "shipper": {
    "name": "Shanghai Electronics Co", // Required
    "address": "123 Export St",        // Optional
    "country": "China",                // Optional
    "contact": "John Doe",             // Optional
    "email": "export@company.cn"       // Optional
  },
  
  "consignee": {
    "name": "EuroPacific Slovenia",    // Required
    "address": "456 Import Ave",       // Optional
    "country": "Slovenia",             // Optional
    "contact": "Jane Smith",           // Optional
    "email": "import@europacific.si"   // Optional
  },
  
  "cargo": {
    "description": "Electronic Parts", // Required
    "commodity": "Electronics",        // Optional
    "hs_code": "8542.31",             // Optional
    "weight_kg": 15000,               // Optional
    "volume_cbm": 32.5,               // Optional
    "packages": 50,                   // Optional
    "package_type": "Cartons",        // Optional
    "is_hazardous": false,            // Optional
    "un_number": null                 // Optional - for DG cargo
  },
  
  "containers": [
    {
      "container_number": "MSCU1234567",
      "container_type": "40HC",
      "seal_number": "SEAL123",
      "weight_kg": 15500
    }
  ],
  
  "vessel_name": "MSC AURORA",         // Optional
  "voyage_number": "FE401W",           // Optional
  "etd": "2026-03-10T00:00:00Z",       // Optional - ISO 8601
  "eta": "2026-04-05T00:00:00Z",       // Optional - ISO 8601
  "service_type": "LCL",               // Optional - FCL or LCL
  "incoterm": "FOB",                   // Optional
  "remarks": "Handle with care"        // Optional
}

Success Response (Matched)

{
  "status": "linked",
  "message": "Shipment linked to existing PF",
  "pf_id": "64abc123def456789",
  "pf_number": "PF-000123-26"
}

Success Response (Queued)

{
  "status": "queued",
  "message": "No matching PF found",
  "queue_id": "64xyz789abc123456",
  "suggestions": [...]
}

Error Responses

401 Unauthorized

Invalid or missing API key

422 Validation Error

Missing required fields or invalid data format

500 Internal Server Error

Server-side error - please contact support

Need Help?

Contact our integration team for API keys, technical support, or to request additional endpoints.