API Documentation

Release 1.3.5, 15 Nov 2024

        Requests

            Method: POST
            URL:
                https://vantage.shipping.langtec.de/<extraction type> (cargo, ship, q88, or timesheet)
                Default Type: https://vantage.shipping.langtec.de/

            Authorization: Basic
                Username: <username>
                Password: <password>

                (Use your API key as a password if you were provided with one)

            Headers:
                Content-Type: multipart/form-data

            Body:
                file: <file1> (Set type as "File" and browse files to upload)
                file: <file2>
                ...

        Extracted Fields

            E.O.S.P,
            HOSE DISCONNECT,
            DROP ANCHOR,
            DOC ON BOARD,
            ARRIVAL,
            ARRIVED,
            COMMENCED ULLAGING /CALCULATION,
            ULLAGING / CALCULATION,
            GANGWAY,
            DOCUMENTATION ON BOARD,
            COMPLETE LOAD,
            COMPLETED DOCUMENTATIONS,
            ARRVD,
            COMPLETED ULLAGING /CALCULATION,
            COMPLETE ULLAGING / CALCULATION,
            CARGO DOCUMENTATION,
            HOSE CONNECT,
            VSL ARRIVED AT PILOT STATION,
            END OF SEA PASSAGE,
            TIME OF ARRIVAL,
            PILOT ON BOARD,
            CARGO DOCUMENTS COMPLETED,
            LINE BLOWING,
            COMPLETED CARGO DOCUMENTATION,
            COMMENCE ULLAGING/ CALCULATION,
            TANKER ARRIVED,
            ALL FAST,
            FIRST LINE ASHORE,
            COMPLETE ULLAGING/CALCULATION,
            GANGWAY DOWN,
            LAST LINE,
            COMPLETED ULLAGING / CALCULATION,
            COMPLETED ULLAGING/ CALCULATION,
            ULLAGING/ CALCULATION,
            DOCUMENTATIONS COMPLETED,
            DOCS ON BOARD,
            COMMENCE CALCULATIONS,
            COMPLETE TANK INSPECTION,
            COMMENCE ULLAGING/CALCULATION,
            COMMENCED ULLAGING / CALCULATION,
            COMMENCED ULLAGING/ CALCULATION,
            DOCS ONBOARD,
            COMMENCED ULLAGING,
            ULLAGING/CALCULATION,
            COMPLETE DISCHARGE,
            EOSP,
            DOC ONBOARD,
            CARGO DOCUMENTS ONBOARD,
            COMMENCE DISCHARGE,
            COMMENCED ULLAGING/CALCULATION,
            VSL ARRIVED,
            NOR TENDER,
            HOSECONNECT,
            ANCHOR AWEIGH,
            COMMENCE LOAD,
            COMPLETE CALCULATIONS,
            ARRIVED PILOT STN,
            COMMENCE ULLAGING / CALCULATION,
            COMPLETE ULLAGING /CALCULATION,
            SAILING ARRANGED,
            COMMENCE ULLAGING /CALCULATION,
            NOR ACCEPTED,
            ULLAGING /CALCULATION,
            E.O.S.P.,
            FREE PRATIQUE GRANTED,
            COMPLETED ULLAGING/CALCULATION,
            COMMENCE TANK INSPECTION,
            COMPLETE ULLAGING/ CALCULATION,
            CARGO DOCUMENTS ONBOARD.,
            DOCUMENTS COMPLETED,
            COMPLETED CARGO DOCUMENTATIONS,
            DOCUMENTS ONBOARD,
            ARRIVAL/EOSP,
            ARRIVAL TIME

        Example

            cURL:
                curl -X POST https://vantage.shipping.langtec.de/ \
                -u username:password \
                -F file=@Email1.eml -F file=@Email2.eml

            python:
                import requests
                from requests.auth import HTTPBasicAuth

                file_paths = ['Email1.eml, Email2.eml']
                files = {'file': (file_path, open(file_path, 'rb')) for file_path in file_paths}
                auth = HTTPBasicAuth('username', 'password')

                response = requests.post('https://vantage.shipping.langtec.de/',
                                         auth=auth,
                                         files=files,
                                         )
                print(response.content)

            (All submitted data will be encrypted and securely transferred to
            LangTec's server.)

            Response

                {
                    "Email1.eml": {
                        "Character Count": 120,
                        "Items": [
                            {
                                "end": null,
                                "start": "2026-05-1 07:00",
                                "task": "EOSP"
                            }
                        ],
                        "Items extracted": 1
                    },
                    "Email2.eml": {
                        "Character Count": 140,
                        "Items": [
                            {
                                "end": "2026-05-1 17:15",
                                "start": "2026-05-1 15:45",
                                "task": "CARGO TANK INSPECTION AND SAMPLING"
                            }
                        ],
                        "Items extracted": 1
                    },
                    "Meta": {
                        "Copyright": "Copyright LangTec 2026",
                        "Email": "info@langtec.de",
                        "Notes": [],
                        "Request UUID": "8dfef0ab-9a31-4163-878b-d1a60cf22a04",
                        "Service Version": "1.3.5",
                        "Subscription Info": [
                            {
                                "completed uploads": 6,
                                "parsers": [
                                    "timesheet",
                                    "q88"
                                ],
                                "remaining requests": "no limit"
                            }
                        ],
                        "Timestamp": "2026-01-01T00:00:00.000000",
                        "Website": "www.langtec.de"
                    }
                }