External API
Docs & Playground
Geo/get_geo_service_center

get_geo_service_centertoken required

Returns when the caller's vehicles arrived at and left their service centre areas: one row per arrival and one per departure, not one per sample.

Try in playground
POST/api— body field action.name = "get_geo_service_center"

Parameters

NameTypeRequiredDescription
vehicle_idnumberoptionalNarrow to one vehicle. Supplied but blank, or non-numeric, is rejected with action_value '2' rather than being read as 'no filter'.e.g. 1234567
license_numberstringoptionalNarrow by licence plate instead of id.e.g. 12-345-67
from_datetimedateoptionalWindow start, UTC. Accepts `YYYY-MM-DD`, `YYYY-MM-DDTHH:mm[:ss]` and the space-separated variant. A non-existent date such as 2026-02-30 is rejected.e.g. 2026-08-01T00:00:00
to_datetimedateoptionalWindow end, same formats as `from_datetime`.e.g. 2026-08-20T23:59:59

Notes

`polygon_status` is 1 for entering the area and 0 for leaving it, so a three-hour visit is two rows. Date defaulting: both dates absent returns the newest 100 rows; only `to_datetime` sets the start to 30 days before it; only `from_datetime` sets the end to now. A windowed request returns up to 10,000 rows. Visits are retained for 30 days, and a window that ends before that floor returns action_value '4' rather than an empty success. Action values: '0' success, '1' user not found, '2' vehicle_id missing from the caller's fleet, not permitted, or supplied in an unusable form (blank or non-numeric), '3' from_datetime later than to_datetime, '4' window older than retention, '999' general error. `date_time` carries no trailing Z, matching the published specification, and `license_number` / `geometry_name` are URL-encoded like every other string field.

Request

curl
curl -X POST 'https://private.develop-1.questar.io/v2/private-questar-units/api' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  --data '{"action":{"name":"get_geo_service_center","parameters":[{"vehicle_id":1234567,"license_number":"12-345-67","from_datetime":"2026-08-01T00:00:00","to_datetime":"2026-08-20T23:59:59"}]}}'
Body
{
  "action": {
    "name": "get_geo_service_center",
    "parameters": [
      {
        "vehicle_id": 1234567,
        "license_number": "12-345-67",
        "from_datetime": "2026-08-01T00:00:00",
        "to_datetime": "2026-08-20T23:59:59"
      }
    ]
  }
}

Response

Successful responses always wrap the action's payload in response.properties. The action_value field reports the handler outcome: "0" for success, "1" for invalid params, "2" for not allowed, "3" for limit-exceeded /pagination-session-expired, "999" for general error.

Authentication is checked before the action runs and fails the same way for every action. A token that is not valid returns HTTP 200 with action_value "2" and description invalid_session; an empty bearer returns "2" with session_token_required. Read the description to tell these apart from an action's own "2". With no Authorization header the gateway answers HTTP 401 {"message":"Unauthorized"}, and with a bearer that is not a token HTTP 403 {"message":"Forbidden"}.

200 OK
{
  "response": {
    "properties": {
      "action_name": "get_geo_service_center",
      "action_value": "0",
      "description": "success",
      "data": [
        {
          "vehicle_id": "1234567",
          "license_number": "12-345-67",
          "date_time": "2026-08-18T07:42:15",
          "latitude": "32.0852999",
          "longitude": "34.7817676",
          "geometry_id": "4521",
          "geometry_name": "Service%20Center%20North",
          "polygon_status": "1"
        }
      ]
    }
  }
}