> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zdlake.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Provenance

> Understand the source context attached to normalized entity fields.

Provenance enriches field values on a Zero entity with the public evidence behind them. It is not a separate entity or a graph that clients need to model.

The base entity remains simple: fields such as severity, publication time, affected ranges, and exploitation status contain normalized values. When provenance is included, Zero adds source context for those fields without replacing each value with a wrapper.

## What provenance adds

| Context | What it tells you |
| - | - |
| Source and publisher | Which upstream organization and dataset supplied the claim. |
| Source value | What the upstream record asserted before normalization. |
| Role | Whether the claim was selected, supported the selected value, or conflicted with other evidence. |
| Reason | Why the resolver used or retained the claim. |
| Source time | When the publisher last modified the supporting record. |
| Record version | The immutable upstream snapshot from which the claim was extracted. |

Provenance entries are associated with entity fields by normalized paths. This allows one field to have evidence from several sources while the field itself continues to expose one usable value.

## How to use it

* Show attribution alongside a risk or remediation value.
* Review disagreements before automating a remediation decision.
* Explain why Zero selected one value from several public claims.
* Preserve an auditable reference to the exact source data used at the time.

For example, a vulnerability can expose one preferred CVSS assessment while its provenance identifies every contributing assessment, the selected source, and the reason it was preferred. An affected range can similarly retain evidence from multiple advisories without changing the normalized range shape.

## Source record versions

A source record version is the immutable evidence behind a provenance entry. It preserves the raw payload, retrieval time, payload hash, upstream schema version, and source identity.

Most clients do not need to retrieve source record versions during normal use. Follow one only when you need the original upstream payload for verification, audit, or debugging.

## API pages

Provenance is an optional projection on entity detail requests. See the relevant retrieval page for its complete response schema:

| Entity | API page |
| - | - |
| Vulnerability | [Get a vulnerability](https://docs.zdlake.com/vulnerabilities/get.md) |
| Advisory | [Get an advisory](https://docs.zdlake.com/advisories/get.md) |
| Weakness | [Get a weakness](https://docs.zdlake.com/weaknesses/get.md) |
| Software | [Get software](https://docs.zdlake.com/software/get.md) |
| Attack pattern | [Get an attack pattern](https://docs.zdlake.com/attack-patterns/get.md) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.