Scan

Scan API is designed to provide result counts for a specified search term along with a direct deeplink to the corresponding data in the Legentic Platform. It enables users to efficiently evaluate data availability for a given query.

Authentication

All requests require an API key. Only Company Admins can generate and manage keys in the Credentials section.

Minimal Search Request

Search term is a flexible field that allows you to connect the identifiers in your claims with our extensive data. Country codes allows you to filter the results by the country of interest. You can also use wildcard symbol ["*"] to search in all the countries your company has access to. This increases the range of your search, but may also return a very large number of results or increase response times.

Including case data with every request enables collaboration across departments.

{
  "search_term": "plate:ABC123",
  "country_codes": ["DE"],
  "case_id": "CASE12345",
  "case_date": "2025-09-04"
}

Adding Price and Time Filters

Adding price and time filters to your request helps categorize findings and provide better insights. For example, ads closer to the case date, or with significant price differences compared to the case amount, may be more relevant than older ads.

{
  "search_term": "plate:ABC123",
  "country_codes": ["DE"],
  "case_id": "CASE12345",
  "case_date": "2025-09-04"
  "case_amount": 10000
  "price_min": 7000,
  "price_max": 15000,
  "start_published_date": "2024-09-04",
  "end_published_date": "2025-09-04"
}

Search Term

It offers flexibility to freely combine soft and hard identifiers when searching based on data from your cases. However, using it too strictly or too loosely can result in either no results or many false positives. Here are some common examples we recommend, based on our experience with clients (not an exhaustive list):

Licence Plate:

 "search_term": "plate:ABC123"

Exact VIN:

 "search_term": "exact_vin:ABCDEFGH123456789"

Email address:

 "search_term": "email:example123@email.com"

Phone number:

 "search_term": "phone:5555555555"

Partial VIN + ZIP Code:

 "search_term": "partial_vin:ABCDEFGH1234 1234"

Partial VIN + City:

 "search_term": "partial_vin:ABCDEFGH1234 Munich"

First Name + Last Name:

 "search_term": "Max Muller"

Profile Name:

 "search_term": "profile_name:Max Muller"

Last Name + Region:

 "search_term": "Muller Bavaria"

Object Profile + City:

 "search_term": "Audi A4 2019 Munich"

Please note that unlike identifiers (e.g., plate:, phone:), values such as names or object profiles are searched as free text. Reach out to us if you require support in building your queries