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"
    }
  ]
}

Parameter	Type	Required	Description
transports	array	Yes	List of transports to be stopped.
codeUit	string	Yes	Unique UIT identification code of the transport.

🕒 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

Property	Type	Description
payload	boolean	The result of the stop operation (`true` if successful).
correlationId	string	Unique request identifier, useful for traceability.
failureReasons	array	List of errors (if any), each with a code and parameters.
isSuccess	boolean	Indicates if the request was processed successfully (`true` or `false`).

Error Responses

HTTP Code	Description
400	Missing, invalid, or incorrectly formatted parameters.
401	Unauthenticated user or insufficient permissions.
429	Rate limit exceeded for the user.