Trace a fact to its source

Follow a response value to the preserved source file, exact locator, and content hash.

Use Gridstate’s provenance fields to verify where a material fact came from and which source bytes produced it.

Request a record with evidence

Expand evidence while listing queue records:

curl -G "$GRIDSTATE_API_BASE/v1/queue-records" \
  -d limit=1 \
  -d expand=evidence \
  -H "Authorization: Bearer $GRIDSTATE_API_KEY" \
  -H "Gridstate-Version: 2026-08-24"

Inspect the provenance fields

Material facts include four identifiers:

Field	Purpose
`sourceId`	Names the registered source
`assetHash`	Pins the preserved source bytes with SHA-256
`sourceLocator`	Identifies the row, cell, page, or API record
`evidenceUrl`	Resolves to the retained evidence response

Fetch the preserved evidence

Follow the record’s evidenceUrl or request it directly:

GET /v1/queue-records/{recordId}/evidence

Use the source locator to compare the normalized value with the preserved row or document location.

Audit provenance coverage

Measure locator coverage across material canonical facts:

curl "$GRIDSTATE_API_BASE/v1/provenance-audit" \
  -H "Authorization: Bearer $GRIDSTATE_API_KEY" \
  -H "Gridstate-Version: 2026-08-24"

The audit reports how much of the canonical dataset has a complete evidence chain.

Distinguish facts from conclusions

Gridstate keeps source observations separate from derived and inferred values:

Kind	Example
Observed	A queue record lists a 201 MW project at a named point of interconnection
Derived	Active queued capacity in a county totals 2,480 MW
Inferred	The public record suggests elevated study and upgrade pressure
Unknown	No authoritative public source states site-specific available capacity
Conflicted	Authoritative sources disagree and no resolution rule is sufficient

Inferences never overwrite confirmed fields

When authoritative sources conflict, Gridstate preserves both assertions and marks the group as conflicted. It does not silently choose one.

Reproduce the same evidence state

Pin Gridstate-Version and add point-in-time parameters to historical queries. This preserves both the contract shape and the requested evidence state.

Use /v1/evidence-search to retrieve document facts that do not yet have a dedicated structured endpoint.