Get Trip API with state and pin code details

1 Introduction
2 API Details
3 Input Parameters
4 Postman collection
5 Responses

Introduction

This document has the complete the get trip details API from tether-server based on trip id and access token

API Details

Method: GET

End Point

Integration Environment: https://integration-api.freighttiger.com/integration/tether/connect /trip/id/<TRIP_ID>

Production Environment: https://api.freighttiger.com/api/tether/connect/trip/id/<TRIP_ID>

Headers: Authorisation: Bearer <Access token for consignor provided by FT>

Can only be accessed using Consignor User token

Input Parameters

Attribute Name	Type	Required	Sample Value

Attribute Name	Type	Required	Sample Value
trip_id	String	true	pass in the url itself
Authorization	String	true	Pass in the headers section

If there is nop details of last_known_location. in get trip response or the trip is not tracked yet then we can not add the state and pin code in trip details.

Postman collection

Responses

status code: 200 OK

{
    "success": true,
    "data": {
        "trip_id": 14718807,
        "feed_unique_id": "0007649187",
        "created_at": "2022-11-11 05:59:00",
        "lr_number": "NA",
        "parties": [
            {
                "name": "JSW - Dolvi",
                "type": "consignor",
                "branch_name": "Dolvi",
                "branch_code": ""
            },
            {
                "name": "Mahindra Logistics Limited - Mahindra JSW Dolvi",
                "type": "transporter"
            },
            {
                "name": "MAHARASTRA SEAMLESS LTD",
                "type": "consignee"
            }
        ],
        "is_round_trip": false,
        "vehicle": {
            "license_plate": "MH46H6012"
        },
        "last_known_location": {
            "point": {
                "latitude": 18.710833,
                "longitude": 73.051111
            },
            "address": "P374+RX8, Indranagar, Odhangi, Maharashtra 402107, India",
            "recorded_at": "2022-11-11 06:42:11",
            "device": {
                "type": "SIM",
                "external_id": null
            },
            "state": "Maharashtra",
            "pincode": "402107"
        },
        "origins": [
            {
                "point": {
                    "latitude": 18.7054,
                    "longitude": 73.0354
                },
                "address": "NH166A, Beneghat, Maharashtra 402107, India",
                "etd": null,
                "atd": null
            }
        ],
        "destinations": [
            {
                "point": {
                    "latitude": 18.48833,
                    "longitude": 73.17694
                },
                "address": "F5QG+8Q Sukeli, Maharashtra, India",
                "distance_from_last_location": 30.232,
                "ata": null,
                "eta": "2022-11-11 07:37:46",
                "eta_updated_at": "2022-11-11 06:43:02"
            }
        ],
        "waypoints": [],
        "drivers": [
            {
                "name": "Unknown Driver",
                "contact": "9044931797"
            }
        ],
        "total_distance": 31.77,
        "start_time": null,
        "end_time": null,
        "close_time": null,
        "status": "Open",
        "status_code": 1,
        "location_source": "sim",
        "custom_params": {
            "destinationPincode": 402126,
            "shipment_number": "0007649187",
            "gateInNumber": 9011604144,
            "gateIn": "11-11-2022 11:28:30"
        },
        "primary_attributes": {
            "feed_unique_id": "0007649187",
            "route_code": "DT-NAG"
        },
        "invoices": null,
        "share_url": "https://www.freighttiger.com/v5/shareTrip?shareKey=TRP-9ffe6789-a77c-4bf6-bfec-bb1f4303c127"
    }
}

{
    "success": false,
    "msg": "Missing required input"
}

{
    "success": false,
    "msg": "INVALID_TOKEN"
}