FORESIGHT · GET
Prediction ledger
GET
/api/v1/foresight/predictionsPaginated public ledger of frozen predictions with outcomes.
Walks the full public foresight ledger — every prediction is frozen before its outcome. Rows marked verifiable resolve to a signed lineage envelope; legacy rows are marked unverifiable until their lineage is backfilled.
PARAMETERS
| NAME | TYPE | REQUIRED | DESCRIPTION |
|---|---|---|---|
| page | integer (≥0) | optional | Page number. Default 0. |
| page_size | integer (1-50) | optional | Records per page. Default 20. |
| batch_id | string | optional | Filter to a specific batch, e.g. fs-batch-0142. |
| status | "unresolved" | "resolved" | "all" | optional | Filter by resolution status. Default "all". |
RESPONSE SHAPE
{ data: ForesightPrediction[], page, page_size, total, _meta }. _meta.source_state tells callers whether rows are live, stale, seeded, or unavailable. Rows carry lineage_verification_status so callers never mistake legacy hashes for signed proof.