{"schema_version":"zero.developer_proof_api.v1","schema":"https://getzero.dev/contracts/zero.developer_proof_api.v1.schema.json","kind":"developer_proof_api","canonical_url":"https://getzero.dev/developers","contract_url":"https://getzero.dev/api/developers/proof","changelog_url":"https://getzero.dev/contracts/zero.developer_proof_api.changelog.v1.json","example_url":"https://getzero.dev/examples/developer-proof-api/fetch-public-replay.mjs","discovery_url":"https://getzero.dev/.well-known/zero.json","published_at":"2026-06-20T00:00:00.000Z","versioning":{"current_version":"zero.developer_proof_api.v1","major_version":1,"stability":"public_beta","version_negotiation":"schema_version_field","compatibility_policy":"v1_additive_only","breaking_change_policy":"new_schema_version_required","deprecation_notice_days":90,"safe_additions":["new read-only endpoint entries","new optional metadata fields","new fixture references","new cache or rate-limit annotations that do not reduce public access without notice"],"breaking_changes":["removing or renaming required fields","changing schema_version without a new schema file","requiring API keys for public proof reads","allowing execution, custody, private-key access, or runtime mutation through this API"],"required_validation":["zero.developer_proof_api.v1 schema validation","fixture replay example validation","public contract validation"]},"auth":{"public_reads":"none","api_keys":"not_required_for_public_proof_reads","operator_mcp":"scoped_bearer_required"},"rate_limits":{"global_public_read":{"requests":100,"window_seconds":60,"scope":"ip","enforcement":"upstash_redis_when_configured_with_per_instance_fallback"}},"safety":{"read_only":true,"paper_first":true,"can_execute_orders":false,"can_mutate_runtime":false,"can_read_private_keys":false,"can_custody_assets":false},"endpoints":[{"id":"discovery","method":"GET","path":"/.well-known/zero.json","url":"https://getzero.dev/.well-known/zero.json","auth":"none","purpose":"Discover public contracts, schemas, endpoints, and safety boundaries.","response_schema":"zero.discovery.v1","schema_url":"https://getzero.dev/contracts/zero.discovery.v1.schema.json","rate_limit_bucket":"global_public_read","cache":"static","can_execute_orders":false,"can_mutate_runtime":false},{"id":"replay_index","method":"GET","path":"/api/replays","url":"https://getzero.dev/api/replays?limit=20","auth":"none","purpose":"List public replay summaries with bounded pagination and filters.","response_schema":"zero.replay_index.v1","schema_url":null,"rate_limit_bucket":"global_public_read","cache":"public, s-maxage=5, stale-while-revalidate=30","can_execute_orders":false,"can_mutate_runtime":false},{"id":"decision_replay","method":"GET","path":"/api/replays/{id}","url":"https://getzero.dev/api/replays/foundation-genesis","auth":"none","purpose":"Fetch one public DECISION_LOOP replay payload.","response_schema":"zero.decision_replay.v1","schema_url":"https://getzero.dev/contracts/zero.decision_replay.v1.schema.json","rate_limit_bucket":"global_public_read","cache":"public, s-maxage=5, stale-while-revalidate=30","can_execute_orders":false,"can_mutate_runtime":false},{"id":"receipt_card","method":"GET","path":"/api/replays/{id}/receipt-card","url":"https://getzero.dev/api/replays/foundation-genesis/receipt-card","auth":"none","purpose":"Fetch a shareable public receipt card without private traces or performance claims.","response_schema":"zero.decision_receipt_card.v1","schema_url":"https://getzero.dev/contracts/zero.decision_receipt_card.v1.schema.json","rate_limit_bucket":"global_public_read","cache":"public, s-maxage=5, stale-while-revalidate=30","can_execute_orders":false,"can_mutate_runtime":false},{"id":"replay_graph_context","method":"GET","path":"/api/replays/{id}/graph-context","url":"https://getzero.dev/api/replays/foundation-genesis/graph-context","auth":"none","purpose":"Fetch retained replay adjacency and hash coverage.","response_schema":"zero.replay_graph_context.v1","schema_url":"https://getzero.dev/contracts/zero.replay_graph_context.v1.schema.json","rate_limit_bucket":"global_public_read","cache":"public, s-maxage=5, stale-while-revalidate=30","can_execute_orders":false,"can_mutate_runtime":false},{"id":"replay_export","method":"GET","path":"/api/replays/export","url":"https://getzero.dev/api/replays/export?limit=20","auth":"none","purpose":"Export replay summaries plus v95 evidence bundle material for offline inspection.","response_schema":"zero.replay_export.v1","schema_url":null,"rate_limit_bucket":"global_public_read","cache":"public, s-maxage=5, stale-while-revalidate=30","can_execute_orders":false,"can_mutate_runtime":false},{"id":"public_operator_profile","method":"GET","path":"/api/public/operators/foundation","url":"https://getzero.dev/api/public/operators/foundation","auth":"none","purpose":"Fetch normalized public operator evidence and proof links.","response_schema":"zero.public_operator.v1","schema_url":"https://getzero.dev/contracts/zero.public_operator.v1.schema.json","rate_limit_bucket":"global_public_read","cache":"public, s-maxage=5, stale-while-revalidate=30","can_execute_orders":false,"can_mutate_runtime":false},{"id":"status","method":"GET","path":"/api/status","url":"https://getzero.dev/api/status","auth":"none","purpose":"Fetch public operational status for runtime, proof, notification, and support readiness.","response_schema":"zero.status.v1","schema_url":"https://getzero.dev/contracts/zero.status.v1.schema.json","rate_limit_bucket":"global_public_read","cache":"public, s-maxage=30, stale-while-revalidate=120","can_execute_orders":false,"can_mutate_runtime":false}],"fixtures":[{"id":"fixture_public_replay","url":"https://getzero.dev/contracts/decision-replay.examples.json","command":"node public/examples/developer-proof-api/fetch-public-replay.mjs --fixture public/contracts/decision-replay.examples.json","validates":["zero.developer_proof_api.v1","zero.decision_replay.v1","zero.decision_receipt_card.v1","zero.replay_graph_context.v1"]}],"integration_flow":[{"step":1,"action":"Read discovery and developer proof contract.","endpoint":"/.well-known/zero.json + /api/developers/proof","validates":"zero.discovery.v1 + zero.developer_proof_api.v1"},{"step":2,"action":"Fetch replay index and choose a replay id.","endpoint":"/api/replays?limit=20","validates":"zero.replay_index.v1"},{"step":3,"action":"Fetch replay detail, receipt card, and graph context.","endpoint":"/api/replays/{id}","validates":"zero.decision_replay.v1 plus companion contracts"},{"step":4,"action":"Export a replay capsule for offline review.","endpoint":"/api/replays/export?limit=20","validates":"zero.replay_export.v1 plus v95 evidence bundle fields"}]}