Last seen Image

With the new Genlogs Last Seen Image feature in carrier observation endpoint, you can receive details of the last time it was detected a truck of the carrier, including the URL for the image, datetime and location.

When the last_seen_image parameter is set to 'True', the carrier observation system includes details related to the recent carrier truck detection according to Genlogs Sensor network.

The last_seen_image parameter is available exclusively to premium users. Reach out to us at [e-mail] now to unlock Last Seen image freight data.

In addition to the base parameters described in Query Parameters:, can be also sent the parameter

1. last_seen_image (boolean, optional): Determine if is needed to return last seen image information. Adds to the response an attribute that contains the information about the last see image for a given carrier in the Genlogs Sensor network, when the user has this functionality enabled.

If you receive a 403 error when using the last_seen_image parameter, it means your user account doesn't have access to this premium feature. Please verify your access level and, if necessary, contact support at [e-mail] for assistance.

In addition to the base attributes described in Response: when the carrier observations request includes the last_seen_image parameter, the response will also include the following attributes

1. last_seen_image (last_seen_image objects): Details of the last seen image.

   1. url: string, address to see the image of the carrier.

   2. timestamp: datetime of the last seen image.

   3. location_city: city where data was captured.

   4. location_state: state where data was captured.

Request Example

curl -X GET 'https://api.genlogs.io/visual_sightings/carrier-observations?usdot_number=3481976&location_city=enfield&location_state=NC&last_seen_image=True' \
-H 'Access-Token: {access_token}' \
-H 'x-api-key: {your_api_key}' \
-i

Carrier Observation including last seen image

get

Query parameters

usdot_numberstringrequired

USDOT number to filter data for a specific carrier

location_cityany of · default: ""

Filter by city where data was captured

location_stateany of · default: ""

Filter by state where data was captured

sighting_start_dateany of · default: ""

Filter by start date

sighting_end_dateany of · default: ""

Filter by end date

last_seen_imageany of · default: false

Include last seen image information

Header parameters

acceptstring · default: "application/json"required

Specifies the format of the response.

Example: application/json

Access-Tokenstringrequired

Access Token for authentication

Example: [Token]

x-api-keystringrequired

API key for authentication

Example: [x-api-key]

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.genlogs.io/visual_sightings/carrier-observations?usdot_number=text' \
  --header 'accept: application/json' \
  --header 'Access-Token: [Token]' \
  --header 'x-api-key: [x-api-key]'

200

200

{
  "data": {
    "fmcsa_detail": [
      {
        "usdot_number": "text",
        "docket_number": "text",
        "legal_name": "text",
        "dba_name": "text",
        "carrier_status": "text",
        "entity_type": "text",
        "carrier_ein": "text",
        "dun_bradstreet_no": "text",
        "mcs150_date": "text",
        "mcs150_mileage": "text",
        "insurer_company_name": "text",
        "insurance_docket_number": "text",
        "insurance_policy_number": "text",
        "insurance_policy_type": "text",
        "insurance_form_code": "text",
        "insurance_max_coverage_amount": "text",
        "insurance_underlying_limit_amount": "text",
        "insurance_transaction_date": "text",
        "insurance_effective_date": "text",
        "insurance_expiration_date": "text",
        "phy_street": "text",
        "phy_city": "text",
        "phy_state": "text",
        "phy_zip": "text",
        "telephone": "text",
        "email_address": "text",
        "mailing_street": "text",
        "mailing_city": "text",
        "mailing_state": "text",
        "mailing_zip": "text",
        "mailing_country": "text",
        "carrier_operation": "text",
        "operation_classificiation": "text",
        "authority_date": "text",
        "authorized_for_common_date": "text",
        "authorized_for_contract_date": "text",
        "carrier_total_drivers": "text",
        "carrier_total_power_units": "text",
        "carried_cargo": "text",
        "carrier_driver_insp": "text",
        "carrier_driver_oos_insp": "text",
        "carrier_driver_oos_rate": 1,
        "carrier_driver_oos_rate_national_avg": 1,
        "carrier_vehicle_insp": "text",
        "carrier_vehicle_oos_insp": "text",
        "carrier_vehicle_oos_rate": 1,
        "carrier_vehicle_oos_rate_national_avg": 1,
        "carrier_hazmat_insp": "text",
        "carrier_hazmat_oos_insp": "text",
        "carrier_hazmat_oos_rate": 1,
        "carrier_hazmat_oos_rate_national_avg": 1,
        "carrier_fatal_crash": "text",
        "carrier_inj_crash": "text",
        "carrier_towaway_crash": "text",
        "carrier_crash_total": "text",
        "recordable_crash_rate": 1,
        "basic_unsafe_driving_total_violation": "text",
        "basic_driver_fitness_total_violation": "text",
        "basic_hos_total_violation": "text",
        "basic_drugs_alcohol_total_violation": "text",
        "BASIC_VEHICLE_MAINT_TOTAL_VIOLATION": "text",
        "carrier_safety_rating_date": "text",
        "carrier_safety_rating": "text",
        "carrier_safety_review_date": "text",
        "carrier_safety_review_type": "text"
      }
    ],
    "observations": [
      {
        "alpr_plate_number": "text",
        "usdot_number": "text",
        "time_captured": "text",
        "mc_number": "text",
        "vin": "text",
        "cab_number": "text",
        "equipment_type": "text",
        "equipment_number": "text",
        "equipment_logo": "text",
        "location_city": "text",
        "location_state": "text",
        "latitude": 1,
        "longitude": 1,
        "route": "text",
        "source": "text"
      }
    ]
  },
  "last-seen-image": {
    "url": "text",
    "timestamp": "text",
    "location_city": "text",
    "location_state": "text"
  }
}

Successful Response