1. V2.0
HLS Open API
  • V2.0
    • Query Booking Data
      GET
    • Query Pre-Alert Documents
      GET
    • Push Pre-Alert Documents
      POST
    • Push Booking Data (Including CPA)
      POST
    • Receive Customer's Booking Confirmation (CBC)
      POST
    • Push ISF Data
      POST
  1. V2.0

Push ISF Data

Developing
UAT
https://uateds.hlsholding.com/dts
UAT
https://uateds.hlsholding.com/dts
POST
https://your-api-url
Developed by customerInitiated by HLSData from HLS
HLS will actively push ISF data to our customers through this interface.
Therefore, for this solution, you are required to parse the request body and provide the corresponding API endpoint URL to us.
You may determine whether to enable authentication and specify the authentication method, and we will cooperate in the development.

Request

Body Params application/jsonRequired

Example
{
    "submission_type": "10",
    "shipment_type": "FCL",
    "house_bill_number": "MY269A03XX",
    "house_bill_issuer_scac": "HNLT",
    "master_bill_number": "ZIMUE465007XXX",
    "master_bill_issuer_scac": "ZIMU",
    "vessel_name": "ZIM EMDEN",
    "voyage": "425E",
    "port_of_loading_code": "MYPEN",
    "port_of_discharge_code": "USJAX",
    "etd": "2026-10-26",
    "eta": "2026-12-20",
    "parties": [
        {
            "party_type": "IM",
            "party_name": "DEMO CONSIGNEE",
            "party_address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "party_city": "RALEIGH",
            "party_state": "NC",
            "party_country": "US"
        },
        {
            "party_type": "SE",
            "party_name": "DEMO CONSIGNEE",
            "party_address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "party_city": "RALEIGH",
            "party_state": "NC",
            "party_country": "US"
        },
        {
            "party_type": "BY",
            "party_name": "DEMO CONSIGNEE",
            "party_address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "party_city": "RALEIGH",
            "party_state": "NC",
            "party_country": "US"
        },
        {
            "party_type": "LG",
            "party_name": "DEMO SHIPPER",
            "party_address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "party_city": "KUALA KEDAH",
            "party_state": "KDH",
            "party_country": "MY"
        },
        {
            "party_type": "CS",
            "party_name": "DEMO SHIPPER",
            "party_address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "party_city": "KUALA KEDAH",
            "party_state": "KDH",
            "party_country": "MY"
        },
        {
            "party_type": "MF",
            "party_name": "DEMO SHIPPER",
            "party_address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "party_city": "KUALA KEDAH",
            "party_state": "KDH",
            "party_country": "MY"
        }
    ],
    "line_items": [
        {
            "harmonized_tariff_number": "94036000",
            "container_number": "MAGU5684XXX",
            "po_number": "272322",
            "so_number": "54865622",
            "commodity": "ELECTRONIC PARTS",
            "manufacturer": {
                "party_name": "DEMO SHIPPER",
                "party_address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
                "party_city": "KUALA KEDAH",
                "party_country": "MY"
            }
        }
    ]
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://your-api-url' \
--header 'Content-Type: application/json' \
--data '{
    "submission_type": "10",
    "shipment_type": "FCL",
    "house_bill_number": "MY269A03XX",
    "house_bill_issuer_scac": "HNLT",
    "master_bill_number": "ZIMUE465007XXX",
    "master_bill_issuer_scac": "ZIMU",
    "vessel_name": "ZIM EMDEN",
    "voyage": "425E",
    "port_of_loading_code": "MYPEN",
    "port_of_discharge_code": "USJAX",
    "etd": "2026-10-26",
    "eta": "2026-12-20",
    "parties": [
        {
            "party_type": "IM",
            "party_name": "DEMO CONSIGNEE",
            "party_address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "party_city": "RALEIGH",
            "party_state": "NC",
            "party_country": "US"
        },
        {
            "party_type": "SE",
            "party_name": "DEMO CONSIGNEE",
            "party_address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "party_city": "RALEIGH",
            "party_state": "NC",
            "party_country": "US"
        },
        {
            "party_type": "BY",
            "party_name": "DEMO CONSIGNEE",
            "party_address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "party_city": "RALEIGH",
            "party_state": "NC",
            "party_country": "US"
        },
        {
            "party_type": "LG",
            "party_name": "DEMO SHIPPER",
            "party_address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "party_city": "KUALA KEDAH",
            "party_state": "KDH",
            "party_country": "MY"
        },
        {
            "party_type": "CS",
            "party_name": "DEMO SHIPPER",
            "party_address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "party_city": "KUALA KEDAH",
            "party_state": "KDH",
            "party_country": "MY"
        },
        {
            "party_type": "MF",
            "party_name": "DEMO SHIPPER",
            "party_address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "party_city": "KUALA KEDAH",
            "party_state": "KDH",
            "party_country": "MY"
        }
    ],
    "line_items": [
        {
            "harmonized_tariff_number": "94036000",
            "container_number": "MAGU5684XXX",
            "po_number": "272322",
            "so_number": "54865622",
            "commodity": "ELECTRONIC PARTS",
            "manufacturer": {
                "party_name": "DEMO SHIPPER",
                "party_address": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
                "party_city": "KUALA KEDAH",
                "party_country": "MY"
            }
        }
    ]
}'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
    "code": 200,
    "success": true,
    "message": "Success"
}
Previous
Receive Customer's Booking Confirmation (CBC)
Built with