Freshness model
Fields to preserve
Store the query, endpoint, response status, source identifiers, and every returned collection or modification timestamp. Common fields include:timestampcutoff_epochfirst_seenandlast_seendate_addedcreated_at,updated_at, andcompleted_at- Vulnerability publication and modification fields
Missing and stale data
An empty response means the API returned no matching records under the current query, access, result limit, and dataset state. It does not prove that an asset, vulnerability, or relationship does not exist. When making a decision:- Record the query and cutoff time.
- Check pagination and result limits.
- Corroborate high-impact ownership or attribution conclusions.
- Re-query according to the decision’s freshness requirement.
- Distinguish
not observed,not returned, andverified absent.
