Genlogs API Docs
  • Genlogs API
  • Getting started
  • AUTH
    • Create token
  • Carrier
    • Carrier Recommendations
      • Real time Capabilities
  • Shipper
    • Shipper Lanes
    • Shipper Facilities
  • VISUAL SIGHTINGS
    • Verify
  • Asset Locator
    • Alert Run Summary
    • Create alert
      • Trailer logos
Powered by GitBook
On this page
  1. VISUAL SIGHTINGS
  2. Carrier Observation

Last seen Image

Last updated 1 month ago

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 support@genlogs.io now to unlock Last Seen image freight data.

In addition to the base parameters described in , 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 support@genlogs.io for assistance.

In addition to the base attributes described in 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

Query Parameters:
Response:

Carrier Observation including last seen image

get
Query parameters
usdot_numberstringRequired

USDOT number to filter data for a specific carrier

location_cityany ofOptional

Filter by city where data was captured

Default: ""
stringOptional
or
nullOptional
location_stateany ofOptional

Filter by state where data was captured

Default: ""
stringOptional
or
nullOptional
sighting_start_dateany ofOptional

Filter by start date

Default: ""
stringOptional
or
nullOptional
sighting_end_dateany ofOptional

Filter by end date

Default: ""
stringOptional
or
nullOptional
last_seen_imageany ofOptional

Include last seen image information

Default: false
booleanOptional
or
nullOptional
Header parameters
acceptstringRequired

Specifies the format of the response.

Default: application/jsonExample: application/json
Access-TokenstringRequired

Access Token for authentication

Example: [Token]
x-api-keystringRequired

API key for authentication

Example: [x-api-key]
Responses
200
Successful Response
application/json
get
GET /visual_sightings/carrier-observations HTTP/1.1
Host: api.genlogs.io
accept: application/json
Access-Token: [Token]
x-api-key: [x-api-key]
Accept: */*
200

Successful Response

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