Skip to main content

Create Custom Search Links in Asset Intelligence (Asset Locator)

Written by Alex Burlingame

When hyperlinking to Asset Intelligence from an external app, it can be helpful to direct users to a specific search or search result. This guide shows how to use URL query parameters to save common searches, share a specific lookup with a teammate, or embed a link in another tool that jumps straight to a filtered result set.

What are URL query parameters?

URL query parameters are a common way of applying search filters in your browser. In Asset Intelligence, they can be used to pre-populate the fields seen in the UI.

How to Build a Custom Link

Start with the base URL, add a ? after the final /, then add one or more key=value pairs separated by &. If a value has a space, replace it with %20 .

For example, a search for trailer number 211243 with an exact match would be constructed as follows:

https://assetlocator.genlogs.io/?trailer_number=211243&exact_match_trailer_number=true

Common Search Parameters

Search Field

Parameter

Example

USDOT

usdot_number

usdot_number=896143

MC Number

mc_number

mc_number=388685

Truck License Plate

license_plate

license_plate=ABC1234

Cab Number

cab_number

cab_number=1221

Power Unit VIN

vin

vin=1FUJGLDR0LLM12345

Trailer Number

trailer_number

trailer_number=211243

Chassis Number

chassis_number

chassis_number=CHAS1234

Container Number

container_number

container_number=fciu638525

Equipment Logo

trailer_logo

trailer_logo=Stg Logistics

Image ID or Record ID

image_unique_id

image_unique_id=IMG12345

State

location_state

location_state=TX

Deep Search box

deep_search

deep_search=896143

Date Range (start)

start_date

start_date=2024-07-12T13:54

Date Range (end)

end_date

end_date=2026-07-18T13:54

Note: Dates use the format YYYY-MM-DD.

Exact match toggles

Each of these sets the corresponding "Exact match" checkbox. Use true to check it.

Parameter

Toggles

exact_match_deep_search

Exact Match, next to the Deep Search box

exact_match_trailer_number

Exact match, next to Trailer Number

exact_match_chassis_number

Exact Match, next to Chassis Number

exact_match_container_number

Exact Match, next to Container Number

Example of an exact-match trailer search:

https://assetlocator.genlogs.io/?trailer_number=d22248&exact_match_trailer_number=true

How to link to a specific search result

Every image and record in Asset Intelligence has a unique ID. Open a record to view and copy these IDs:

Then, pass in the ID to either the corresponding Image ID or Record ID field in the UI or as a query parameter.

Searching for record 01f2ddf4cce173b3a836a99adcd0f57707f8f0c566d5a2aec083d39fbdedcf58 in the UI:

Searching for the same record via a query parameter:

https://assetlocator.genlogs.io/?image_unique_id=01f2ddf4cce173b3a836a99adcd0f57707f8f0c566d5a2aec083d39fbdedcf58

Other examples

A link to every record for a given USDOT, filtered to the last two years:

https://assetlocator.genlogs.io/?usdot_number=896143&start_date=2024-07-21T00:00&end_date=2026-07-21T23:59

A link for a specific trailer, exact match only, restricted to intermodal equipment:

https://assetlocator.genlogs.io/?trailer_number=TRAIL1&exact_match_trailer_number=true&equipment_type=Intermodal

A link scoped to a carrier logo and a state:

https://assetlocator.genlogs.io/?trailer_logo=Pepsi&location_state=TX

Notes

  • Hazmat filter are not supported with URL query parameters at this time

  • Unrecognized parameters are ignored; they do not break the rest of the search.

  • Parameters can be combined freely across the confirmed list above.

  • Some searches may not be visually apparent in the UI when applied as a query parameter. For instance, equipment_type=Intermodal does filter results, but the Equipment Type dropdown on the page does not visually show the value as selected when loaded from a URL.

  • If a saved link stops returning what's expected, check that the field names above still match, this list reflects the app's behavior as tested and could shift in a future release.


Still need help? Email [email protected] for further assistance.

Did this answer your question?