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 [email protected] now to unlock Last Seen image freight data.

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

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 [email protected] 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

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 ofOptional

Filter by city where data was captured

Default: ""

stringOptional

nullOptional

location_stateany ofOptional

Filter by state where data was captured

Default: ""

stringOptional

nullOptional

sighting_start_dateany ofOptional

Filter by start date

Default: ""

stringOptional

nullOptional

sighting_end_dateany ofOptional

Filter by end date

Default: ""

stringOptional

nullOptional

last_seen_imageany ofOptional

Include last seen image information

Default: false

booleanOptional

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": "55773",
        "docket_number": "mc2580",
        "legal_name": "CRST EXPEDITED INC",
        "dba_name": "CRST THE TRANSPORTATION SOLUTION INC",
        "carrier_status": "Active",
        "entity_type": "Carrier, Broker",
        "carrier_ein": "420750182",
        "dun_bradstreet_no": "7793383",
        "mcs150_date": "2025-01-23",
        "mcs150_mileage": "2022",
        "insurer_company_name": "SELF-INSURED",
        "insurance_docket_number": "MC1235",
        "insurance_policy_number": "NA",
        "insurance_policy_type": "BIPD/Primary",
        "insurance_form_code": "91X",
        "insurance_max_coverage_amount": "1000000",
        "insurance_underlying_limit_amount": "0",
        "insurance_transaction_date": "2002-09-05",
        "insurance_effective_date": "2002-10-01",
        "insurance_expiration_date": "2003-10-01",
        "phy_street": "3930 16TH AVE SW",
        "phy_city": "CEDAR RAPIDS",
        "phy_state": "IA",
        "phy_zip": "52404",
        "telephone": "3193964400",
        "email_address": "[email protected]",
        "mailing_street": "PO BOX 68",
        "mailing_city": "CEDAR RAPIDS",
        "mailing_state": "IA",
        "mailing_zip": "52406",
        "mailing_country": "US",
        "carrier_operation": "Interstate",
        "operation_classificiation": "OTHER-GENERAL FREIGHT (EXCEPT HOUSEHOLD GOODS) | AUTHORIZED FOR HIRE",
        "authority_date": "1992-10-21",
        "authorized_for_common_date": "2011-10-26",
        "authorized_for_contract_date": "1992-10-21",
        "carrier_total_drivers": "3785",
        "carrier_total_power_units": "4050",
        "carried_cargo": "General Freight | Metal: sheets, coils, rolls | etc.",
        "carrier_driver_insp": "6830",
        "carrier_driver_oos_insp": "45",
        "carrier_driver_oos_rate": 0.66,
        "carrier_driver_oos_rate_national_avg": 5.51,
        "carrier_vehicle_insp": "4365",
        "carrier_vehicle_oos_insp": "818",
        "carrier_vehicle_oos_rate": 18.74,
        "carrier_vehicle_oos_rate_national_avg": 20.72,
        "carrier_hazmat_insp": "71",
        "carrier_hazmat_oos_insp": "1",
        "carrier_hazmat_oos_rate": 1.41,
        "carrier_hazmat_oos_rate_national_avg": 4.5,
        "carrier_fatal_crash": "8",
        "carrier_inj_crash": "97",
        "carrier_towaway_crash": "198",
        "carrier_crash_total": "303",
        "recordable_crash_rate": 0,
        "basic_unsafe_driving_total_violation": "594",
        "basic_driver_fitness_total_violation": "81",
        "basic_hos_total_violation": "234",
        "basic_drugs_alcohol_total_violation": "8",
        "BASIC_VEHICLE_MAINT_TOTAL_VIOLATION": "2478",
        "carrier_safety_rating_date": "2014-05-23",
        "carrier_safety_rating": "Satisfactory",
        "carrier_safety_review_date": "2024-12-16",
        "carrier_safety_review_type": "New Entrant"
      }
    ],
    "observations": [
      {
        "alpr_plate_number": "p760855",
        "usdot_number": "3481976",
        "time_captured": "2024-06-05T20:28:06Z",
        "mc_number": "mc758629",
        "vin": "vincn556288",
        "cab_number": "56288",
        "equipment_type": "Reefer",
        "equipment_number": "123",
        "equipment_logo": "Pepsi",
        "location_city": "enfield",
        "location_state": "NC",
        "latitude": 4.56,
        "longitude": -84.36,
        "route": "95sb",
        "source": "genlogs"
      }
    ]
  },
  "last-seen-image": {
    "url": "https://genlogs-trident-test-stack.s3.amazonaws.com/..../A300.jpg",
    "timestamp": "2024-10-02T20:40:47",
    "location_city": "Fairmont",
    "location_state": "IN"
  }
}

Last updated 3 months ago