Get a List of Journeys

Retrieve a list of journeys within a specified date range.

Query String Parameters

Name	Type	Description	Required
Action	String	Journeys	Required
Start	DateTime	UTC Date and Time you want journey data from. Allowed Values: YYYY-MM-DD	Required
End	DateTime	UTC Date and Time you want journey data until. Allowed Values: YYYY-MM-DD	Required
ShowIdling	Int	Default is 0. Set to 1 to include idling information in the response dataset	Optional

Response Codes

Code	Message	Information
0	Response Data	See 'Response' example tab
2	Start and End Parameters expected	Mandatory parameter was not supplied
2	misc_noRight	You do not have the permissions to access live tracking information.

Example

Request

Request URL

https://webservice.bigchange.com/v01/services.ashx?action=journeys&Start=2024-07-01 07:00:00&End=2024-07-02 08:00:00

Response

Response Data

{
  "Code": 0,
  "Result": [
    {
      "Asset": "XTR-8972",
      "Start": "2024-07-01 07:03:41",
      "StartLat": 53.3023,
      "StartLng": -6.69391,
      "StartAdd": "Elm Street, Springfield",
      "Stop": "2024-07-01 12:44:03",
      "StopLat": 53.35861,
      "StopLng": -6.4174,
      "StopAdd": "Maple Avenue, Rivertown",
      "Stop4Job": false,
      "Distance": 105.38,
      "MaxSpeed": 54.1,
      "Idling": "01:49:34",
      "Driving": "03:50:48"
    },
    {
      "Asset": "YHR-2138",
      "Start": "2024-07-01 07:45:03",
      "StartLat": 52.60442,
      "StartLng": -8.93589,
      "StartAdd": "Oak Road, Springfield",
      "Stop": "2024-07-01 08:04:35",
      "StopLat": 52.63643,
      "StopLng": -8.69354,
      "StopAdd": "Pine Street, Limerick",
      "Stop4Job": false,
      "Distance": 11.33,
      "MaxSpeed": 56.5,
      "Idling": "00:00:00",
      "Driving": "00:19:32"
    },
    {
      "Asset": "PRX-6891",
      "Start": "2024-07-01 14:20:54",
      "StartLat": 52.63669,
      "StartLng": -8.69253,
      "StartAdd": "Greenfield Drive, Mungret",
      "Stop": "2024-07-01 14:48:18",
      "StopLat": 52.64852,
      "StopLng": -8.58402,
      "StopAdd": "Riverbend Road, Limerick",
      "Stop4Job": false,
      "Distance": 8.01,
      "MaxSpeed": 53.4,
      "Idling": "00:07:24",
      "Driving": "00:20:00"
    }
  ]
}

note

• Time Zone: Dates provided in the response will be interpreted according to the time zone of the logged-in user.
• Units of Measurement: Speed, distance and odometer data will be presented in either kilometers or miles, depending on the logged-in user's settings.
• Contact Information: The StartContact and StopContact details will only be included in the response if the journey began or ended at a known contact.