# Request historical location and environmental data

Returns historical data.

Endpoint: POST /agent-service/v1/agent/exec/e4735852-45a4-4d73-a4b4-b13b60fc5dfe
Version: 1.3.0.0
Security: bearerAuth

## Header parameters:

  - `customer_id` (string, required)
    Customer ID for the request
    Example: "c89c432b-12b7-4956-8be4-904a5e95df23"

  - `authorized_groups` (string, required)
    Authorized groups for access control
    Example: "cb2c60c7-9b47-41af-ab05-9d3fdbff44e5"

## Request fields (application/json):

  - `context` (object, required)

  - `context.authorized_groups` (string, required)
    Example: "cb2c60c7-9b47-41af-ab05-9d3fdbff44e5"

  - `context.customer_id` (string, required)
    Example: "c89c432b-12b7-4956-8be4-904a5e95df23"

  - `context.filters` (object, required)

  - `context.filters.customer_asset_id` (string)
    customer asset identifier, connected to Trackonomy tape
    Example: "999-2440 0001-0001"

  - `context.filters.event_type` (string)
    location option returns data without sensor readings, environment option returns both location and sensor data.
    Enum: "location", "environment"

  - `context.filters.from` (string)
    show events from this date, time in UTC
    Example: "2025-02-07T09:02:34Z"

  - `context.filters.to` (string)
    show events until this date, time in UTC
    Example: "2025-02-07T09:02:34Z"

  - `context.filters.trk_asset_id` (string)
    Trackonomy tape QR Code
    Example: "9E-240125-08-K1B226"

## Response 200 fields (application/json):

  - `data` (object)

  - `data.events` (array)

  - `data.events.battery` (object,null)

  - `data.events.battery.charge` (string)
    Indicator for battery charge level with HIGH being a fresh battery, MED being normal operating range and LOW showing a battery reaching its EOL.
    Enum: "HIGH", "MED", "LOW"

  - `data.events.customer_asset_id` (string)
    asset identifier connected to Trackonomy tape at the time of association
    Example: "AC_NY_MN_1_1"

  - `data.events.event_type` (string)
    Example: "environment"

  - `data.events.lat` (number)
    Example: 40.6635742

  - `data.events.location` (string)
    For in-mesh events, facility name, otherwise state and country
    Example: "New York, USA"

  - `data.events.location_detailed` (string)
    For in-mesh events, facility zone name, otherwise city name
    Example: "Bellmore"

  - `data.events.lon` (number)
    Example: -73.52722932

  - `data.events.sensors` (array)
    only those sensors, which are active on the tape, will be returned

  - `data.events.sensors.type` (string)
    Enum: "ambient_temp", "probe_temp", "shock", "humidity", "pressure", "light"

  - `data.events.sensors.units` (string)
    Example: "C"

  - `data.events.timestamp` (string)
    event time, in UTC
    Example: "2025-04-29T18:10:20Z"

  - `data.events.trk_asset_id` (string)
    Trackonomy tape QR Code
    Example: "9E-240125-08-K1B226"

  - `data.version` (string)
    Example: "1.2.0"

## Response 400 fields (application/json):

  - `data` (object)

  - `data.message` (string)
    Example: "Input validation error: Missing mandatory parameter: customer_id"

  - `data.status` (string)
    Example: "error"

## Response 401 fields (application/json):

  - `code` (integer)
    HTTP status code associated with the error
    Example: 500

  - `message` (string)
    Error message describing what went wrong
    Example: "Internal Server Error"

## Response 500 fields (application/json):

  - `code` (integer)
    HTTP status code associated with the error
    Example: 500

  - `message` (string)
    Error message describing what went wrong
    Example: "Internal Server Error"