Login

General Description

The login endpoint is used for authenticating users within the API.
It receives a username and password in the request body, and if the authentication is valid, it returns an access token (JWT) along with a refresh token.
These tokens must be used to authorize requests to protected API resources.

⚠️ All requests to this endpoint must include the api-version=2.0 parameter in the URL.
URL: POST https://api.trackgps.ro/api/authentication/login?api-version=2.0

Request Parameters

Requests to this endpoint must be of type POST and include:

• Query parameter:

  • api-version: the API version. Recommended value: 2.0.

• The payload must be sent in the request body as form data with the following structure:

{
  "username": "user@example.com",
  "password": "SecretPassword123"
}

Property Descriptions

• username: The username or email address used for authentication.
• password: The password associated with the account.

Response Structure

A successful response (HTTP 200) will have the following format:

{
    "access_token": "eyJhbGciOavJZdtmkv3s9OW4ljE2V225_uTkntrDo-SDYwFGgYLbpQ",
    "expires_in": 28800,
    "token_type": "Bearer",
    "refresh_token": "8E65181908146821C79E26259683DF6F-1",
    "scope": "CarPoolingAPI IdentityServerApi offline_access openid profile TrackGPSV4Api"
}

Property Descriptions

• access_token: The JWT token used to authorize subsequent API requests.
• expires_in: The token’s validity duration (in seconds).
• token_type: The type of token, generally “Bearer”.
• refresh_token: Token that can be used to refresh the session without re-authentication.
• scope: List of permissions associated with the token.

Error Responses

• 400 Bad Request – Missing parameters or incorrect request structure.
• 401 Unauthorized – Invalid credentials or inactive user.
• 429 Too Many Requests – Rate limit exceeded for the current user.

Company Vehicles

General Description

The CompanyVehicles method returns the list of vehicles and their details. It only returns vehicles to which the user has access.
From the response of this method, you can retrieve the vehicleId values, which can be used in subsequent API calls.

This method is subject to Rate Limit restrictions.

⚠️ All requests to this endpoint must include the api-version=2.0 parameter in the URL.
URL: GET https://api.trackgps.ro/api/carriers/company-vehicles?api-version=2.0

⚠️ Note: All date and time values sent or returned by this endpoint are in the company’s local time zone.

Response Structure

{
  "payload": [
    {
      "vehicleId": 0,
      "vehicleUId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "vehicleName": "string",
      "vehicleRegistrationNumber": "string",
      "latitude": 0,
      "longitude": 0,
      "gpsDate": "2024-09-09T08:52:55.005",
      "address": "string",
      "speed": 0,
      "course": 0,
      "engineEvent": 0,
      "engineRpm": 0,
      "engineEventDate": "2024-09-09T08:52:55.005",
      "serverDate": "2024-09-09T08:52:55.005",
      "isPrivate": true,
      "vehicleIdentificationNumber": "string",
      "externalPowerVoltage": 0,
      "vehicleManufacturer": "string",
      "vehicleModel": "string",
      "manufactureYear": 0
    }
  ],
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

Property Descriptions

• payload: List of vehicles and their details.
  • vehicleId: Unique ID of the vehicle.
  • vehicleUId: Universal unique ID of the vehicle.
  • vehicleName: Name of the vehicle.
  • vehicleRegistrationNumber: Vehicle registration number.
  • latitude: Latitude of the vehicle’s location.
  • longitude: Longitude of the vehicle’s location.
  • gpsDate: Date and time of the last GPS update.
  • address: Address of the vehicle’s location.
  • speed: Vehicle speed.
  • course: Vehicle travel direction.
  • engineEvent: Engine event.
  • engineRpm: Engine RPM.
  • engineEventDate: Date and time of the engine event.
  • serverDate: Server date and time at the moment of response.
  • isPrivate: Indicates if the vehicle is in private mode.
  • vehicleIdentificationNumber: Vehicle Identification Number (VIN).
  • externalPowerVoltage: Power supply voltage.
  • vehicleManufacturer: Vehicle manufacturer.
  • vehicleModel: Vehicle model.
  • manufactureYear: Vehicle manufacture year.
• correlationId: Unique ID for correlating the request and response.
• failureReasons: List of failure reasons, if any.
  • errorCode: Error code.
  • errorParameters: Additional error parameters.
• isSuccess: Indicates if the request was processed successfully.

Way

General Description

The Way method returns the list of vehicle locations for the period provided as a parameter. It only returns vehicles to which the user has access. The method accepts as parameters a list of up to 10 vehicleId values and a period of up to 31 days.

It is subject to the restrictions described in Rate Limit

⚠️ All requests to this endpoint must include the api-version=2.0 parameter in the URL.
URL: POST https://api.trackgps.ro/api/carriers/way?api-version=2.0

⚠️ Note: All date and time values sent or returned by this endpoint are in the company’s local time zone.

Request Parameters

{
  "vehiclesList": [
    0
  ],
  "startDate": "2024-09-09T09:21:50.133Z",
  "endDate": "2024-09-09T09:21:50.133Z"
}

• vehiclesList: List of vehicleId values for which you want to obtain locations.
• startDate: Start date and time of the period for which locations are requested.
• endDate: End date and time of the period for which locations are requested.

Response Structure

{
  "payload": [
    {
      "vehicleId": 0,
      "gpsDate": "2024-09-09T09:21:50.134",
      "latitude": 0,
      "longitude": 0,
      "speed": 0,
      "course": 0
    }
  ],
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

Property Descriptions

• payload: List of vehicle locations.
  • vehicleId: Unique ID of the vehicle.
  • gpsDate: Date and time of the last GPS update.
  • latitude: Latitude of the vehicle’s location.
  • longitude: Longitude of the vehicle’s location.
  • speed: Speed of the vehicle.
  • course: Direction of vehicle movement.
• correlationId: Unique ID for correlating the request and response.
• failureReasons: List of failure reasons, if any.
  • errorCode: Error code.
  • errorParameters: Additional parameters for the error.
• isSuccess: Indicator if the request was processed successfully.

Stops

General Description

The Stops method returns a list of vehicle stops within the requested period. It only returns data for vehicles the user has access to. If the list contains at least one vehicle the user does not have access to, a response with error code 401 will be returned.

It is subject to the Rate Limit restrictions.

⚠️ All requests to this endpoint must include the api-version=2.0 parameter in the URL.
URL: POST https://api.trackgps.ro/api/carriers/stops?api-version=2.0

⚠️ Note: All date and time values sent or returned by this endpoint are in the company’s local time zone.

Request Parameters

{
  "vehiclesList": [
    0
  ],
  "startDate": "2024-09-09T09:49:19.549",
  "endDate": "2024-09-09T09:49:19.549",
  "stationaryMargin": 0
}

• vehiclesList: List of vehicle IDs for which stops are requested (maximum 10 vehicles).
• startDate: Start date and time of the period for which stops are requested.
• endDate: End date and time of the period for which stops are requested.
• stationaryMargin: Stop duration in minutes (cannot be less than 1 minute).

Response Structure

{
  "payload": [
    {
      "results": {
        "additionalProp1": [
          {
            "vehicleId": 0,
            "startDate": "2025-04-11T14:33:30.175",
            "endDate": "2025-04-11T14:33:30.175",
            "latitude": 0,
            "longitude": 0,
            "stationaryEngineOnTime": 0,
            "distance": 0,
            "maxSpeed": 0,
            "averageSpeed": 0,
            "speedCount": 0,
            "indexKm": 0,
            "indexHours": 0,
            "address": "string",
            "stopDuration": 0,
            "engineOnStops": [
              {
                "startDate": "2025-04-11T14:33:30.175",
                "endDate": "2025-04-11T14:33:30.175",
                "duration": 0
              }
            ],
            "hotSpot": "string",
            "functioningTime": 0,
            "isPrivate": true,
            "drivers": [
              {
                "firstName": "string",
                "lastName": "string"
              }
            ],
            "fuelConsumption": 0
          }
        ],
        "additionalProp2": [
          {
            "vehicleId": 0,
            "startDate": "2025-04-11T14:33:30.175",
            "endDate": "2025-04-11T14:33:30.175",
            "latitude": 0,
            "longitude": 0,
            "stationaryEngineOnTime": 0,
            "distance": 0,
            "maxSpeed": 0,
            "averageSpeed": 0,
            "speedCount": 0,
            "indexKm": 0,
            "indexHours": 0,
            "address": "string",
            "stopDuration": 0,
            "engineOnStops": [
              {
                "startDate": "2025-04-11T14:33:30.175",
                "endDate": "2025-04-11T14:33:30.175",
                "duration": 0
              }
            ],
            "hotSpot": "string",
            "functioningTime": 0,
            "isPrivate": true,
            "drivers": [
              {
                "firstName": "string",
                "lastName": "string"
              }
            ],
            "fuelConsumption": 0
          }
        ],
        "additionalProp3": [
          {
            "vehicleId": 0,
            "startDate": "2025-04-11T14:33:30.175",
            "endDate": "2025-04-11T14:33:30.175",
            "latitude": 0,
            "longitude": 0,
            "stationaryEngineOnTime": 0,
            "distance": 0,
            "maxSpeed": 0,
            "averageSpeed": 0,
            "speedCount": 0,
            "indexKm": 0,
            "indexHours": 0,
            "address": "string",
            "stopDuration": 0,
            "engineOnStops": [
              {
                "startDate": "2025-04-11T14:33:30.175",
                "endDate": "2025-04-11T14:33:30.175",
                "duration": 0
              }
            ],
            "hotSpot": "string",
            "functioningTime": 0,
            "isPrivate": true,
            "drivers": [
              {
                "firstName": "string",
                "lastName": "string"
              }
            ],
            "fuelConsumption": 0
          }
        ]
      }
    }
  ],
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

Property Descriptions

• payload: List of vehicle stops.
  • results: Stop results for each vehicle.
    • vehicleId: Vehicle ID.
    • startDate: Start date and time of the stop.
    • endDate: End date and time of the stop.
    • latitude: Latitude of the stop location.
    • longitude: Longitude of the stop location.
    • stationaryEngineOnTime: Time spent stopped with the engine on.
    • distance: Distance traveled.
    • maxSpeed: Maximum speed reached.
    • averageSpeed: Average speed.
    • speedCount: Number of speed measurements.
    • indexKm: Kilometer index.
    • indexHours: Hour index.
    • address: Address of the stop location.
    • stopDuration: Duration of the stop.
    • engineOnStops: List of events with the engine on.
      • startDate: Start date and time of the stop with the engine on.
      • endDate: End date and time of the stop with the engine on.
      • duration: Duration of the stop with the engine on.
    • hotSpot: Hotspot name if the stop occurred in a defined hotspot.
    • functioningTime: Operating time.
    • isPrivate: Indicator if the stop is private.
    • drivers: List of drivers.
      • firstName: Driver’s first name.
      • lastName: Driver’s last name.
    • fuelConsumption: Fuel consumption for the previous trip and current stop (if stopped with the engine on).
• correlationId: Unique ID for correlating the request and response.
• failureReasons: List of failure reasons, if any.
  • errorCode: Error code.
  • errorParameters: Additional error parameters.
• isSuccess: Indicator if the request was processed successfully.

Consumption

General Description

The Consumption method returns information about fuel consumption, distance, operating hours, as well as the average consumption per 100 km for a vehicle during the requested period. The method can be called for a list of up to 10 vehicles and a period of up to 31 days. If the vehicle is equipped with LPG, data will be returned for both sources.

It is subject to the Rate Limit restrictions.

⚠️ All requests to this endpoint must include the api-version=2.0 parameter in the URL.
URL: POST https://api.trackgps.ro/api/carriers/consumption?api-version=2.0

⚠️ Note: All date and time values sent or returned by this endpoint are in the company’s local time zone.

JSON Request Structure

{
  "vehiclesList": [
    0
  ],
  "startDate": "2024-09-09T07:15:14.124",
  "endDate": "2024-09-09T07:15:14.124"
}

Request Properties

• vehiclesList: List of vehicles for which the method is called (array of vehicleId).
• startDate: Start date of the period for which the method is called.
• endDate: End date of the period for which the method is called.

JSON Response Structure

{
  "payload": [
    {
      "vehicleName": "string",
      "licensePlate": "string",
      "distance": 0,
      "hours": "string",
      "consumptionValue": 0,
      "averageConsumption100Km": 0,
      "secondarySource": {
        "distance": 0,
        "hours": "string",
        "consumptionValue": 0,
        "averageConsumption100Km": 0
      }
    }
  ],
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

Response Properties

Primary Properties

• vehicleName: Name of the vehicle (string).
• licensePlate: License plate number (string).
• distance: Distance traveled in km (numeric).
• hours: Operating hours in timespan format hours:minutes:seconds (string).
• consumptionValue: Fuel consumption value in liters (numeric).
• averageConsumption100Km: Average consumption per 100 km in l/100km (numeric).

Secondary Source Properties

• secondarySource.distance: Distance traveled by the secondary source in km (numeric).
• secondarySource.hours: Operating hours of the secondary source in timespan format hours:minutes:seconds (string).
• secondarySource.consumptionValue: Consumption value for the secondary source in liters (numeric).
• secondarySource.averageConsumption100Km: Average consumption per 100 km for the secondary source in l/100km (numeric).

Calculating Totals

If the secondary source contains data, to obtain the totals you must sum the data from the primary and secondary sources. For example:

{
  "payload": [
    {
      "vehicleName": "Vehicle A",
      "licensePlate": "AB-12-BCD",
      "distance": 100,
      "hours": "10:00:00",
      "consumptionValue": 50,
      "averageConsumption100Km": 5,
      "secondarySource": {
        "distance": 50,
        "hours": "5:00:00",
        "consumptionValue": 20,
        "averageConsumption100Km": 4
      }
    }
  ],
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "isSuccess": true
}

Totals:

• distance: 100 + 50 = 150 km
• hours: 10:00:00 + 5:00:00 = 15:00:00
• consumptionValue: 50 + 20 = 70 liters
• averageConsumption100Km: (5 + 4) / 2 = 4.5 l/100km

Refills

General Description

The Refills method returns a list of refueling or fuel level decrease events detected within the requested period. It only returns data for vehicles to which the user has access.
If the list contains at least one vehicle to which the user does not have access, a response with error code 401 will be returned.

This method is subject to Rate Limit restrictions.

⚠️ All requests to this endpoint must include the api-version=2.0 parameter in the URL.
URL: POST https://api.trackgps.ro/api/carriers/refills?api-version=2.0

⚠️ Note: All date and time values sent or returned by this endpoint are in the company’s local time zone.

Request Parameters

{
  "carrierId": 0,
  "startDate": "2024-09-09T09:42:51.835",
  "endDate": "2024-09-09T09:42:51.835"
}

• carrierId: The unique ID of the vehicle for which you want to obtain refueling or fuel level decrease events.
• startDate: The start date and time of the period for which events are requested.
• endDate: The end date and time of the period for which events are requested.

Response Structure

{
  "payload": [
    {
      "date": "string",
      "event": "string",
      "location": "string",
      "estimation": 0,
      "isPrivate": true
    }
  ],
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

Property Descriptions

• payload: List of refueling or fuel level decrease events.
  • date: The date and time of the event.
  • event: The type of event (refueling or fuel level decrease).
  • location: The location where the event occurred.
  • estimation: The estimated amount of fuel involved in the event.
  • isPrivate: Indicates if the event was performed privately.
• correlationId: Unique ID for correlating the request and response.
• failureReasons: List of failure reasons, if any.
  • errorCode: The error code.
  • errorParameters: Additional parameters for the error.
• isSuccess: Indicates if the request was processed successfully.

List of Possible Events

• FuelStart: Initial fuel level
• Fueling: Refueling
• PossibleFuelTheft: Possible fuel theft
• TotalRefill: Total refuelings
• TotalPossibleTheft: Total possible fuel thefts
• RemainingFuel: Remaining fuel
• TotalFuelConsumption: Total fuel consumption
• FuelStartSecondarySource: Start of refueling from secondary source
• FuelingSecondarySource: Refueling from secondary source
• PossibleFuelTheftSecondarySource: Possible fuel theft from secondary source
• TotalRefillSecondarySource: Total refuelings from secondary source
• TotalPossibleTheftSecondarySource: Total possible thefts from secondary source
• RemainingFuelSecondarySource: Remaining fuel from secondary source
• TotalFuelConsumptionSecondarySource: Total fuel consumption from secondary source

Temperatures

General Method Description

The Temperatures method returns a list of recorded temperatures for the requested period. It only returns data for vehicles the user has access to. If the list contains at least one vehicle the user does not have access to, a response with error code 401 will be returned.

This method is subject to Rate Limit restrictions.

⚠️ All requests to this endpoint must include the api-version=2.0 parameter in the URL.
URL: POST https://api.trackgps.ro/api/carriers/temperatures?api-version=2.0

⚠️ Note: All date and time values sent or returned by this endpoint are in the company’s local time zone.

Request Parameters

{
  "vehiclesList": [
    0
  ],
  "startDate": "2024-09-09T09:49:19.549",
  "endDate": "2024-09-09T09:49:19.549"
}

• vehiclesList: The list of vehicles for which temperature data is requested.
• startDate: The start date of the period for which data is requested.
• endDate: The end date of the period for which data is requested.

Response Structure

{
  "payload": [
    {
      "temperature": [
        {
          "vehicleId": 0,
          "date": "2025-04-11T12:33:11.817",
          "value": 0,
          "sensorNumber": 0
        }
      ],
      "humidity": [
        {
          "vehicleId": 0,
          "date": "2025-04-11T12:33:11.817",
          "value": 0,
          "sensorNumber": 0
        }
      ]
    }
  ],
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

• payload: Contains the results with temperature data.
• correlationId: A unique identifier for correlating the request and response.
• failureReasons: The reasons why the request failed, if any.
• isSuccess: Indicates whether the request was successful.

Add transport

General Description

The add-transport endpoint allows you to add a new transport to the system. The user can specify all details related to the transport, including the associated vehicle, start and end dates, locations, and additional information such as the associated trailer.

It is subject to the restrictions in Rate Limit

⚠️ All requests to this endpoint must include the api-version=2.0 parameter in the URL.
URL: POST https://api.trackgps.ro/api/eTransport/add-transport?api-version=2.0

Request Parameters

Requests to this endpoint must be of type POST and include the following parameters:

• Query parameter:

  • api-version (string, required) – API version. Recommended value: 2.0

• Body (JSON):

{
  "vehicleUId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "startDate": "2025-04-09T07:38:24.380Z",
  "endDate": "2025-04-09T07:38:24.380Z",
  "codeUit": "string",
  "notes": "string",
  "startLocation": "string",
  "endLocation": "string",
  "vatNumber": "string",
  "validityStartDate": "2025-04-09T07:38:24.380Z",
  "validityEndDate": "2025-04-09T07:38:24.380Z",
  "trailer1Code": "string",
  "trailer2Code": "string"
}

🕒 Important: All date fields (e.g. startDate, endDate, validityStartDate, validityEndDate) must be sent in UTC format.

Response Structure

{
  "payload": true,
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

Property Description

Error Responses

Update transport

General Description

The update-transport endpoint allows you to modify an existing transport in the system. You can update details such as the period, locations, notes, or trailer information.

It is subject to the restrictions in Rate Limit

⚠️ All requests to this endpoint must include the api-version=2.0 parameter in the URL.
URL: POST https://api.trackgps.ro/api/eTransport/update-transport?api-version=2.0

Request Parameters

Requests to this endpoint must be of type POST and include the following parameters:

• Query parameter:

  • api-version (string, required) – The API version. Recommended value: 2.0

• Body (JSON):

{
  "transportUId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "vehicleUId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "startDate": "2025-04-09T07:38:24.380Z",
  "endDate": "2025-04-09T07:38:24.380Z",
  "notes": "string",
  "startLocation": "string",
  "endLocation": "string",
  "vatNumber": "string",
  "validityStartDate": "2025-04-09T07:38:24.380Z",
  "validityEndDate": "2025-04-09T07:38:24.380Z",
  "trailer1Code": "string",
  "trailer2Code": "string"
}

🕒 Important: Date fields (startDate, endDate, validityStartDate, validityEndDate) must be sent in UTC format.

Response Structure

{
  "payload": true,
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
  {
    "errorCode": "string",
    "errorParameters": [
    "string"
    ]
  }
  ],
  "isSuccess": true
}

Property Descriptions

Error Responses

Transport List

General Description

The load-transports endpoint is used to retrieve the list of available transports in a user’s account, based on their vehicle access rights. The user can specify parameters to filter transports, such as their status or a specific search value.

This endpoint is subject to Rate Limit restrictions.

⚠️ All transport date/time fields in the response are recorded in the company’s time zone, not UTC. Ensure that transports are managed according to the company’s time zone settings when retrieved from the system.

⚠️ All requests to this endpoint must include the api-version=2.0 parameter in the URL.
URL: POST https://api.trackgps.ro/api/eTransport/load-transports?api-version=2.0

⚠️ Transports with the status “Error” shown in the mobile and web applications are not returned by this endpoint.

Request Parameters

Requests to this endpoint must be of type POST and include the following parameters:

• Query parameter:

  • api-version (string, required) – The API version. Recommended value: 2.0

• Body (JSON):

{
  "pageSize": 0,
  "pageIndex": 0,
  "statusIds": [
  1
  ],
  "searchValue": "string"
}

Transport Status List

Response Structure

{
  "payload": {
  "totalRecords": 0,
  "transports": [
    {
    "uId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "carrierCode": "string",
    "carrierName": "string",
    "carrierUId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "trailer1Code": "string",
    "trailer2Code": "string",
    "codeUit": "string",
    "statusId": 0,
    "startDate": "2025-05-16T14:35:04.862Z",
    "endDate": "2025-05-16T14:35:04.862Z",
    "validityStartDate": "2025-05-16T14:35:04.862Z",
    "validityEndDate": "2025-05-16T14:35:04.862Z",
    "notes": "string",
    "startLocation": "string",
    "endLocation": "string",
    "externalId": 0,
    "externalResponse": "string",
    "lastSyncDate": "2025-05-16T14:35:04.862Z",
    "transmissionStatusCode": "string",
    "transmissionStatusErrorDescription": "string",
    "lastTransmissionDate": "2025-05-16T14:35:04.862Z",
    "lastGpsDate": "2025-05-16T14:35:04.862Z",
    "changeRequestMessage": "string",
    "changeRequestStatusCode": "string",
    "changeRequestCreatedAt": "2025-05-16T14:35:04.862Z",
    "changeRequestDate": "2025-05-16T14:35:04.862Z",
    "changeRequestAnafStatus": "string",
    "changeRequestAnafMessage": "string",
    "changeRequestAnafDate": "2025-05-16T14:35:04.862Z"
    }
  ]
  },
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
  {
    "errorCode": "string",
    "errorParameters": [
    "string"
    ]
  }
  ],
  "isSuccess": true
}

Property Descriptions

GPS Data Transmission Status List in the ANAF Platform

Status List for Transport Data Change Requests

Error Responses

Remove transports

General Description

The remove-transports endpoint allows you to delete one or more transports from the system, based on their unique identifiers (transportUId). This action is irreversible and requires appropriate access rights for the targeted transports.

It is subject to the restrictions described in Rate Limit

⚠️ All requests to this endpoint must include the api-version=2.0 parameter in the URL.
URL: POST https://api.trackgps.ro/api/eTransport/remove-transports?api-version=2.0

Request Parameters

Requests to this endpoint must use the POST method and include the following parameters:

• Query parameter:

  • api-version (string, required) – The API version. Recommended value: 2.0

• Body (JSON):

{
  "transportsUids": [
  "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}

Response Structure

{
  "payload": true,
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
  {
    "errorCode": "string",
    "errorParameters": [
    "string"
    ]
  }
  ],
  "isSuccess": true
}

Property Descriptions

Error Responses

Start data session

General Description

The start-transports endpoint allows you to start (activate) one or more already created transports. This action sets the start date of the transport and marks it as active in the system.

It is subject to the restrictions described in Rate Limit

⚠️ All requests to this endpoint must include the api-version=2.0 parameter in the URL.
URL: POST https://api.trackgps.ro/api/eTransport/start-transports?api-version=2.0

Request Parameters

Requests to this endpoint must be of type POST and include the following parameters:

• Query parameter:

  • api-version (string, required) – The API version. Recommended value: 2.0

• Body (JSON):

{
  "transports": [
    {
      "codeUit": "string"
    }
  ]
}

🕒 Important: All dates (startDate) must be sent in UTC format.

Response Structure

{
  "payload": {
    "codeUit": "string",
    "isSuccess": true,
    "errors": [
      "string"
    ]
  },
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

Property Descriptions

Error Responses

Stop data session

General Description

The end-transports endpoint allows stopping one or more active transports based on the UIT code. By performing this action, the transports are marked as finished in the system and can no longer be modified.

It is subject to the restrictions from Rate Limit

⚠️ All requests to this endpoint must include the api-version=2.0 parameter in the URL.
URL: POST https://api.trackgps.ro/api/eTransport/end-transports?api-version=2.0

Request Parameters

Requests to this endpoint must be of type POST and include the following parameters:

• Query parameter:

  • api-version (string, required) – The API version. Recommended value: 2.0

• Body (JSON):

{
  "transports": [
    {
      "codeUit": "string"
    }
  ]
}

🕒 Important: All dates (endDate) must be sent in UTC format.

Response Structure

{
  "payload": {
    "codeUit": "string",
    "isSuccess": true,
    "errors": [
      "string"
    ]
  },
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

Property Descriptions

Error Responses

Pause data session

General Description

The pause-transports endpoint allows pausing the position transmission of an active transport, based on the UIT code. Similar to start and stop, transports are temporarily paused.

It is subject to the restrictions described in Rate Limit.

⚠️ All requests to this endpoint must include the api-version=2.0 parameter in the URL.
URL: POST https://api.trackgps.ro/api/eTransport/pause-transports?api-version=2.0

Request Parameters

Requests to this endpoint must be of type POST and include the following parameters:

• Query parameter:

  • api-version (string, required) – API version. Recommended value: 2.0

• Body (JSON):

{
  "transports": [
    {
      "codeUit": "string"
    }
  ]
}

Response Structure

{
  "payload": true,
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

Property Descriptions

Error Responses