Getting Last Mile Requests

This guide walks you through getting previously created Last Mile Requests from the JUSDA API.

Authentication

JUSDA uses API keys for authentication. At this time API keys are assigned by JUSDA's Technology Team. To obtain a key, contact your JUSDA Sales representative.

Once you have an API key, to authenticate, it will be necessary to pass the key in the HTTP header of each call you make. For the header key pass x-api-key. Pass your key as the value. For example: x-api-key=34A81032-979E-4EFC-9A6F-87E2973F3E20

If there is any problem authenticating your key, the API will respond with an HTTP 401 code.

Testing

JUSDA may provide you an API key that is set to our test environment. If instead you have a production API key, it's possible to use the test environment on any API call by including an environment attribute in the endpoint's query string. For example:

https://services.jusdausa.com/api/v1/Rates?environment=Test

API Endpoint

The URL for JUSDA APIs is:

https://services.jusdausa.com/api/v1

To this endpoint add the resource you are accessing. For example, the endpoint to get Last Mile Requests is:

https://services.jusdausa.com/api/v1/LastMileRequests

Last Mile Requests URL Parameters

The /LastMileRequests API accepts various filter values in its query string. Here are some example API calls with an explanation of how the query will execute.

https://services.jusdausa.com/api/v1/LastMileRequests?referenceNo=Jan20Test

The above example will retrieve the Last Mile Request where the reference number is Jan20Test.

https://services.jusdausa.com/api/v1/LastMileRequests

The above example will retrieve all last mile requests for the account.

Last Mile Request Query String Parameters

Use any of the following parameters in your HTTP GET query string to filter your search for existing bookings.

referenceNo: (optional) Retrieve a specific reference number

Sample Response Payload


            [
                {
                    "LastMileRequestId": "1863e498-ee01-42b9-e6d9-08d8bd9be56f",
                    "ReferenceNo": "Jan20Test",
                    "ReferenceType": "LOAD",
                    "DriverMobileTelNo": "13107810084",
                    "DriverName": "Bill White",
                    "DispatcherEmailAddress": "dispatcher@jusdausa.com",
                    "SenderEmailAddress": "jusda@jusdausa.com",
                    "RequestUpdateFrequencyMinutes": 1440,
                    "UseVoice": false,
                    "UniqueId": "NmqjUHscYao",
                    "NotificationSent": true,
                    "DispatcherEmailSent": true,
                    "LastMileRequestUpdates": [
                        {
                            "StatusCode": "ART",
                            "StatusTime": "2021-01-20T15:41:12.3764195-08:00",
                            "LocationDescription": null,
                            "Latitude": 33.574078,
                            "Longitude": -117.660904,
                            "SenderEmailSent": true,
                            "CreateDate": "2021-01-20T23:41:12.3764209"
                        }
                    ]
                }
            ]

API Documentation

For more details about the Last Mile API endpoint, see JUSDA's API Documentation.