{ "openapi": "3.1.0", "x-zeroclick-navigation": { "fullSpec": "https://agents.machina.gg/zcj/ibypm0cxs2w4/openapi.json", "services": "https://agents.machina.gg/zcj/ibypm0cxs2w4/services", "serviceSpecTemplate": "https://agents.machina.gg/zcj/ibypm0cxs2w4/services/{slug}/openapi.json", "searchTemplate": "https://agents.machina.gg/zcj/ibypm0cxs2w4/openapi.json?q={text}", "operationTemplate": "https://agents.machina.gg/zcj/ibypm0cxs2w4/openapi.json?path={path}&method={method}", "firstPage": "https://agents.machina.gg/zcj/ibypm0cxs2w4/openapi.json?page=1", "instructions": [ "Use this spec if it contains the operation and details you need. Otherwise, search or open a relevant service spec using the links below.", "Find service slugs in x-zeroclick-services or x-payment-info.rates[].service; use them in serviceSpecTemplate, never as request values.", "URL-encode template values. Search is ranked; service, path, and method filters are exact. Filters combine.", "Pages contain up to 10 operations; follow info.x-next or the Link header if you need more results. Shared operations retain all selector values." ] }, "info": { "title": "Machina Sports", "version": "1.0.0", "description": "Machina's sports intelligence APIs for agents. World Cup 2026: canonical entity resolution across providers, fixtures, standings, squads, injuries, per-player performance context, Dixon-Coles match forecasts with historical backtests, and finished editorial content. Prediction markets: paste a Kalshi or Polymarket game link and get reference prices across supported venues, with timestamps and coverage. Every endpoint is a synchronous POST that returns grounded, source-cited JSON. This server is a pay-per-use, transparent proxy in front of Machina Sports's own API: it handles identity, payment, and proxying. Agents can purchase autonomously or with their human's approval. The complete verified paid surface is listed at /openapi.json, the source of truth for available operations. Each operation here carries its live price in x-payment-info. Use the operations and details here when they meet your needs. Filtered specs contain only matching operations; if you cannot find what you need here, use search or the service catalog. The live catalog at /manifest.json is authoritative for prices and any free included units (prices[].includedUnits) - some meters include free usage per account before any charge, reserved for agents claimed by a human with a verified email.", "x-guidance": "Start with the free seller advisor: POST https://agents.machina.gg/zcj/ibypm0cxs2w4/zeroclick/agent/quote with your goal and known budget or requirements. This operation costs $0 and requires only an x402 or MPP wallet proof; it returns a guide and never executes a purchase. Without a wallet, GET https://agents.machina.gg/zcj/ibypm0cxs2w4/zeroclick/agent/guide?goal=URL_ENCODED_TASK or POST to that guide. Other operations below are the direct API reference; their own prices and access requirements still apply. Call the operations listed in this document at https://agents.machina.gg. Each service's full price matrix, plans, and how to buy are at https://agents.machina.gg/zcj/ibypm0cxs2w4/services/{slug}; each operation's x-payment-info names the service it bills by slug (rates[].service). Slugs identify services in prices and usage reports and are never request values: when one operation serves several services, its request body schema lists the accepted values of the field that selects the service, so send one of those exactly as written. An unpaid call returns 402 Payment Required with a signed challenge; settle it with a supported payment method - x402 (Base USDC) or MPP (Tempo USDC) today - and retry with the proof attached. No upstream API key is needed, and an agent without a payment method can set one up instantly at no cost. Read GET https://agents.machina.gg/zcj/ibypm0cxs2w4/manifest.json for the live services, meters, plans, prices, and any free included units, and https://agents.machina.gg/zcj/ibypm0cxs2w4/llms-full.txt for the full agent guide, including how the free allowance works without funding (it requires an agent identity claimed by a human with a verified email)." }, "x-service-info": { "categories": [ "data" ], "docs": { "homepage": "https://machina.gg/world-cup-api", "apiReference": "https://agents.machina.gg/zcj/ibypm0cxs2w4/openapi.json", "llms": "https://agents.machina.gg/zcj/ibypm0cxs2w4/llms.txt" } }, "externalDocs": { "url": "https://agents.machina.gg/zcj/ibypm0cxs2w4/llms-full.txt", "description": "How to authenticate, pay, and call this API; links the upstream API reference." }, "servers": [ { "url": "https://agents.machina.gg/zcj/ibypm0cxs2w4", "description": "Pay-per-use access to Machina Sports's API" } ], "security": [ { "payPerUse": [] } ], "components": { "securitySchemes": { "payPerUse": { "type": "apiKey", "in": "header", "name": "x-payment", "description": "Pay-per-use access. An unpaid call returns 402 Payment Required with a signed challenge; settle it with a supported payment method (x402 or MPP today) and retry with the proof in this header (x402) or as Authorization: Payment (MPP; use ZC-Agent-Authorization for a separate buyer bearer). No upstream API key is needed, and an agent without a payment method can set one up instantly at no cost." }, "sellerAgentX402": { "type": "apiKey", "in": "header", "name": "Payment-Signature", "description": "Signed $0 x402 proof from the 402 challenge" }, "sellerAgentMpp": { "type": "http", "scheme": "Payment", "description": "Signed $0 MPP proof from the 402 challenge" } }, "schemas": { "sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref0": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "examples": [ "https://polymarket.com/event/nfl-ne-chi-2026-10-23" ], "maxLength": 512, "minLength": 1, "description": "`https://polymarket.com/event/[/]` or `https://kalshi.com/markets///`, single games only.\n" } }, "additionalProperties": false }, "sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref1": { "oneOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref2" }, { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref10" } ] }, "sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref2": { "type": "object", "required": [ "contract", "service", "request", "observed_at", "billable", "status", "event", "source_market", "reference_prices", "coverage", "price_basis", "execution_guaranteed", "limitations", "warnings", "error" ], "properties": { "error": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref9" } ] }, "event": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref3" } ] }, "status": { "enum": [ "ok", "partial", "error" ] }, "request": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": [ "string", "null" ] } }, "additionalProperties": false }, "service": { "const": "market-link-snapshot" }, "billable": { "type": "boolean" }, "contract": { "const": "sports-market-link-snapshot/1" }, "coverage": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref8" } ] }, "warnings": { "type": "array", "items": { "enum": [ "partial_coverage", "source_market_not_in_comparison" ] } }, "limitations": { "type": "array", "items": { "enum": [ "full_game_moneyline_only", "reference_prices_not_executable", "no_settlement_equivalence", "venue_coverage_not_guaranteed" ] } }, "observed_at": { "type": "string", "description": "When Machina received the prices; not a venue timestamp." }, "price_basis": { "const": "reference" }, "source_market": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref4" } ] }, "reference_prices": { "oneOf": [ { "type": "null" }, { "type": "object", "required": [ "home", "away" ], "properties": { "away": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref6" }, "home": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref6" } }, "additionalProperties": false } ] }, "execution_guaranteed": { "const": false } }, "additionalProperties": false }, "sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref3": { "type": "object", "required": [ "espn_event_id", "sport", "home_team", "away_team", "start_time" ], "properties": { "sport": { "type": [ "string", "null" ] }, "away_team": { "type": [ "string", "null" ] }, "home_team": { "type": [ "string", "null" ] }, "start_time": { "type": [ "string", "null" ] }, "espn_event_id": { "type": "string" } }, "additionalProperties": false }, "sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref4": { "type": "object", "properties": { "url": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "sport": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "title": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "venue": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "status": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "event_id": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "outcomes": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "question": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "market_id": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "event_slug": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "market_slug": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "espn_event_id": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "series_ticker": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "market_tickers": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "in_downstream_search": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" } }, "description": "Allowlisted identity of the resolved venue market, as the SDK reported it.", "additionalProperties": false }, "sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5": { "type": [ "string", "boolean", "null", "array" ], "items": { "type": "string" } }, "sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref6": { "type": "object", "required": [ "team", "quotes", "lowest_reference" ], "properties": { "team": { "type": [ "string", "null" ] }, "quotes": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref7" } }, "lowest_reference": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref7" } ] } }, "additionalProperties": false }, "sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref7": { "type": "object", "required": [ "venue", "implied_probability", "price_basis", "execution_guaranteed", "observed_at" ], "properties": { "venue": { "type": "string" }, "provider": { "type": [ "string", "null" ], "description": "ESPN quotes only." }, "observed_at": { "type": "string" }, "price_basis": { "const": "reference" }, "source_captured_at": { "type": [ "string", "null" ], "description": "ESPN quotes only." }, "implied_probability": { "type": "number", "maximum": 1, "exclusiveMinimum": 0 }, "execution_guaranteed": { "const": false } }, "additionalProperties": false }, "sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref8": { "type": "object", "required": [ "usable_sources", "attempted_sources", "missing", "complete" ], "properties": { "missing": { "type": "array", "items": { "type": "object", "required": [ "venue", "reason" ], "properties": { "kind": { "type": "string", "description": "Failure kind; reason error only." }, "venue": { "type": "string" }, "reason": { "enum": [ "empty", "unmatched", "error" ] } }, "additionalProperties": false } }, "complete": { "type": "boolean" }, "usable_sources": { "type": "array", "items": { "type": "string" } }, "attempted_sources": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref9": { "type": "object", "required": [ "code", "kind", "detail" ], "properties": { "code": { "enum": [ "ambiguous_game", "ambiguous_market", "game_not_matched", "invalid_request", "market_not_found", "no_usable_prices", "provider_unavailable", "unsupported_market", "unsupported_url" ] }, "kind": { "type": [ "string", "null" ], "description": "provider_unavailable only: failure kind (timeout, saturated, unknown, ...)." }, "detail": { "enum": [ "body_not_object", "unknown_field", "url_required", "url_too_long", null ], "description": "invalid_request only." } }, "additionalProperties": false }, "sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref10": { "type": "object", "required": [ "contract", "service", "request", "observed_at", "billable", "status", "market_type", "settlement_period", "event", "source_market", "reference_prices", "coverage", "price_basis", "execution_guaranteed", "limitations", "warnings", "error" ], "properties": { "error": { "oneOf": [ { "type": "null" }, { "type": "object", "required": [ "code", "kind", "detail" ], "properties": { "code": { "const": "no_usable_prices" }, "kind": { "type": "null" }, "detail": { "type": "null" } }, "additionalProperties": false } ] }, "event": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref3" }, "status": { "enum": [ "ok", "partial", "error" ] }, "request": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string" } }, "additionalProperties": false }, "service": { "const": "market-link-snapshot" }, "billable": { "type": "boolean" }, "contract": { "const": "sports-market-link-snapshot/2" }, "coverage": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref14" }, "warnings": { "type": "array", "items": { "enum": [ "partial_coverage", "source_market_not_in_comparison", "missing_outcome_price" ] }, "description": "`missing_outcome_price`: at least one of home/away/draw has no usable quote; status is partial." }, "limitations": { "type": "array", "items": { "enum": [ "regulation_three_way_moneyline_only", "reference_prices_not_executable", "no_settlement_equivalence", "venue_coverage_not_guaranteed" ] } }, "market_type": { "const": "three_way_moneyline" }, "observed_at": { "type": "string", "description": "When Machina received the prices; not a venue timestamp." }, "price_basis": { "const": "reference" }, "source_market": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref11" }, "reference_prices": { "type": "object", "required": [ "home", "away", "draw" ], "properties": { "away": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref12" }, "draw": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref12" }, "home": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref12" } }, "additionalProperties": false }, "settlement_period": { "const": "regulation" }, "execution_guaranteed": { "const": false } }, "additionalProperties": false }, "sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref11": { "type": "object", "required": [ "market_type", "settlement_period", "sport", "espn_event_id" ], "properties": { "url": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "sport": { "const": "ucl" }, "title": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "venue": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "status": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "event_id": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "outcomes": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "question": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "market_id": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "event_slug": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "market_slug": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "market_type": { "const": "three_way_moneyline" }, "espn_event_id": { "type": "string" }, "series_ticker": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "market_tickers": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" }, "settlement_period": { "const": "regulation" }, "in_downstream_search": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref5" } }, "description": "The `/1` allowlist plus the two validated markers; no settlement text.", "additionalProperties": false }, "sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref12": { "type": "object", "required": [ "team", "quotes", "lowest_reference" ], "properties": { "team": { "type": [ "string", "null" ] }, "quotes": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref13" } }, "lowest_reference": { "oneOf": [ { "type": "null" }, { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref13" } ] } }, "additionalProperties": false }, "sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref13": { "type": "object", "required": [ "venue", "implied_probability", "price_basis", "execution_guaranteed", "observed_at" ], "properties": { "venue": { "type": "string" }, "contract": { "type": "string", "description": "Venue contract identity, as the SDK reported it. Reference only." }, "provider": { "type": [ "string", "null" ], "description": "ESPN quotes only." }, "token_id": { "type": "string", "description": "Polymarket outcome token, when reported. Reference only." }, "observed_at": { "type": "string" }, "price_basis": { "const": "reference" }, "source_captured_at": { "type": [ "string", "null" ], "description": "ESPN quotes only." }, "implied_probability": { "type": "number", "maximum": 1, "exclusiveMinimum": 0 }, "execution_guaranteed": { "const": false } }, "additionalProperties": false }, "sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref14": { "type": "object", "required": [ "usable_sources", "attempted_sources", "missing", "complete" ], "properties": { "missing": { "type": "array", "items": { "type": "object", "allOf": [ { "if": { "properties": { "reason": { "const": "partial" } } }, "then": { "required": [ "missing_sides" ] } } ], "required": [ "venue", "reason" ], "properties": { "kind": { "type": "string" }, "venue": { "type": "string" }, "reason": { "enum": [ "empty", "unmatched", "error", "partial" ] }, "missing_sides": { "type": "array", "items": { "enum": [ "home", "away", "draw" ] }, "minItems": 1, "uniqueItems": true } }, "additionalProperties": false } }, "complete": { "type": "boolean" }, "usable_sources": { "type": "array", "items": { "type": "string" } }, "attempted_sources": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": false }, "sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref15": { "type": "object", "required": [ "error", "discovery" ], "properties": { "error": { "const": "zeroclick_signature_required" }, "discovery": { "const": "/markets/v1/link-snapshot" } }, "additionalProperties": false }, "sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref16": { "type": "object", "required": [ "error" ], "properties": { "error": { "const": "invalid_zeroclick_signature" } }, "description": "The ZeroClick seller SDK's signature refusal, verbatim.", "additionalProperties": false }, "sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref17": { "type": "object", "required": [ "error" ], "properties": { "error": { "const": "zeroclick_identity_required" } }, "additionalProperties": false }, "sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref18": { "type": "object", "required": [ "error" ], "properties": { "error": { "const": "payment_required" } }, "description": "The ZeroClick seller SDK's payment challenge, returned unchanged. Only `error` is fixed here; every other member is owned by the SDK.\n" }, "sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref19": { "type": "object", "required": [ "error" ], "properties": { "error": { "enum": [ "request_in_progress", "request_id_reused" ] } }, "additionalProperties": false }, "sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref20": { "type": "object", "required": [ "error" ], "properties": { "error": { "const": "rate_limited" } }, "additionalProperties": false }, "sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref21": { "type": "object", "required": [ "error" ], "properties": { "error": { "enum": [ "allowance_unavailable", "zeroclick_not_configured", "zeroclick_runtime_not_configured", "zeroclick_decision_unexpected", "zeroclick_dedup_unavailable" ] } }, "description": "Refused before any work; no error details.", "additionalProperties": false }, "sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref0": { "type": "object", "required": [ "code" ], "properties": { "code": { "type": "integer", "description": "Mirrors the HTTP status code." } }, "description": "Platform-owned envelope metadata." }, "sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref1": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref2" }, { "type": "object", "required": [ "finished_fixtures", "status", "audited_count", "total_count", "included_count", "excluded_count", "exclusion_reasons", "sources", "track_record" ], "properties": { "status": { "const": "available" }, "sources": { "type": "array", "items": { "type": "string" } }, "clv_report": { "type": "object" }, "total_count": { "const": 104 }, "track_record": { "type": "object", "required": [ "sample_size", "sample_size_sufficient", "brier_scores", "accuracy", "calibration", "recommendation" ] }, "audited_count": { "const": 98 }, "excluded_count": { "const": 6 }, "included_count": { "const": 98 }, "exclusion_reasons": { "type": "object", "required": [ "forecast_at_or_after_kickoff" ] }, "finished_fixtures": { "type": "array", "maxItems": 104, "minItems": 104 }, "calibration_report": { "type": "object" } } } ] }, "sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref2": { "type": "object", "required": [ "archive", "coverage", "warnings" ], "properties": { "archive": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref3" }, "coverage": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref4" }, "warnings": { "type": "array", "items": { "type": "string" } } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref3": { "type": "object", "required": [ "mode", "version", "status", "competition", "competition_status", "live", "snapshot_as_of", "capability_status", "provenance", "missing_capabilities", "notes" ], "properties": { "live": { "const": false }, "mode": { "const": "final_archive" }, "notes": { "type": "array", "items": { "type": "string" } }, "status": { "enum": [ "hit", "miss", "unavailable", "error" ], "type": "string", "description": "hit = an immutable archived row was served. unavailable/error = nothing was served; see coverage.reason_code. A `miss` never reaches the public surface." }, "version": { "enum": [ "world-cup-2026-final-v2", "world-cup-2026-final-v3" ], "type": "string" }, "provenance": { "type": "array", "items": { "type": "string" } }, "competition": { "const": "FIFA World Cup 2026" }, "reason_code": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string" }, "snapshot_as_of": { "type": [ "string", "null" ] }, "response_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "capability_status": { "type": "string" }, "competition_status": { "const": "completed" }, "content_created_at": { "type": [ "string", "null" ] }, "source_observed_at": { "type": [ "string", "null" ] }, "timestamp_semantics": { "type": "string" }, "missing_capabilities": { "type": "array", "items": { "type": "string" } }, "source_manifest_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "request_identity_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref4": { "type": "object", "required": [ "schema_version", "status", "reason", "scope", "mode", "source_provenance", "population_count", "eligible_count", "included_count", "excluded_count", "exclusion_reasons", "unsupported_fields" ], "properties": { "mode": { "const": "historical" }, "scope": { "const": "completed_tournament_archive" }, "reason": { "type": "string", "minLength": 1 }, "status": { "enum": [ "complete", "partial", "unavailable", "error" ], "type": "string" }, "reason_code": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string", "description": "Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed." }, "eligible_count": { "type": [ "integer", "null" ], "minimum": 0 }, "excluded_count": { "type": [ "integer", "null" ], "minimum": 0 }, "included_count": { "type": [ "integer", "null" ], "minimum": 0 }, "schema_version": { "const": "worldcup-storefront-coverage-v1" }, "accepted_fields": { "type": "array", "items": { "type": "string" }, "description": "The request fields this endpoint accepts, echoed on unserved responses so an agent can self-correct." }, "population_count": { "type": [ "integer", "null" ], "minimum": 0, "description": "Null means the legacy response did not record this count; null is never equivalent to zero." }, "exclusion_reasons": { "type": "object", "additionalProperties": { "type": "integer", "minimum": 0 } }, "source_provenance": { "type": "array", "items": { "type": "string" } }, "unsupported_fields": { "type": "array", "items": { "type": "string" } } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref5": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref2" }, { "type": "object", "properties": { "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref6" } } } } ] }, "sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref6": { "type": "object", "required": [ "event_urn", "name", "start_date", "status", "teams", "fixture_id" ], "properties": { "name": { "type": "string" }, "round": { "type": [ "string", "null" ] }, "score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref8" }, "stage": { "type": [ "string", "null" ] }, "teams": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref9" }, "minItems": 2 }, "venue": { "type": [ "string", "null" ] }, "status": { "type": "string" }, "event_urn": { "type": "string" }, "fixture_id": { "type": [ "string", "integer" ] }, "start_date": { "type": "string" }, "competition": { "type": "string" }, "result_details": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref7" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref7": { "type": "object", "required": [ "schema_version", "fixture_id", "status", "regulation_time_score", "extra_time_score_contribution", "shootout_score", "winner", "provenance" ], "properties": { "status": { "enum": [ "FT", "AET", "PEN" ], "type": "string" }, "winner": { "type": [ "object", "null" ], "properties": { "name": { "type": "string" }, "team_id": { "type": "string" }, "qualifier": { "type": "string" } } }, "fixture_id": { "type": "string" }, "provenance": { "type": "object", "required": [ "provider", "fixture_id", "provider_result_sha256", "source_url", "observed_at" ], "properties": { "provider": { "type": "string" }, "fixture_id": { "type": "string" }, "source_url": { "type": "string", "format": "uri" }, "observed_at": { "type": [ "string", "null" ] }, "provider_result_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "schema_version": { "const": "worldcup-result-details-v1" }, "shootout_score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref8" }, "regulation_time_score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref8" }, "extra_time_score_contribution": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref8" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref8": { "type": [ "object", "null" ], "properties": { "away": { "type": "integer", "minimum": 0 }, "home": { "type": "integer", "minimum": 0 }, "elapsed": { "type": "number", "minimum": 0 } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref9": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string" }, "crest": { "type": [ "string", "null" ] }, "team_urn": { "type": [ "string", "null" ] }, "qualifier": { "type": "string" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref10": { "type": "object", "required": [ "meta", "status", "data", "error" ], "properties": { "data": { "type": "object", "description": "Always empty on an error." }, "meta": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref0" } ] }, "error": { "type": "object", "required": [ "code", "message" ], "properties": { "code": { "type": "integer", "description": "Mirrors the HTTP status code." }, "type": { "enum": [ "selector_required", "selector_ambiguous", "unsupported_parameter", "not_found", "capability_unavailable", "archive_error" ], "type": "string", "description": "Gateway classification of an unserved answer (absent on auth/credit errors)." }, "billed": { "const": false, "description": "Always false on an unserved answer: no credit debit, no ZeroClick usage." }, "archive": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref3" }, "message": { "type": "string" }, "coverage": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref4" }, "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref6" }, "description": "Fixtures that matched an ambiguous selector." }, "top_up_url": { "type": "string", "description": "On 402 only: where to buy credits." }, "reason_code": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref11" }, "accepted_fields": { "type": "array", "items": { "type": "string" }, "description": "Request fields the endpoint accepts; use them to correct the call." } } }, "status": { "const": "error" } }, "description": "Transport envelope of every non-2xx answer (machina-client-api core/worldcup/gateway.py). Unserved archived answers (selector missing or ambiguous, unknown fixture, unsupported parameter, capability gap) are typed here and are never billed." }, "sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref11": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string", "description": "Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed." }, "sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref0": { "type": "object", "anyOf": [ { "required": [ "event_urn" ] }, { "required": [ "provider_event_id" ] }, { "required": [ "event" ] }, { "required": [ "team" ] } ], "properties": { "date": { "type": "string", "format": "date", "description": "Fixture date, YYYY-MM-DD." }, "team": { "type": "string", "description": "One team name." }, "event": { "type": "string", "description": "Fixture label such as Brazil vs Morocco." }, "opponent": { "type": "string", "description": "Opponent name used to disambiguate." }, "event_urn": { "type": "string", "description": "Canonical event URN." }, "provider_event_id": { "type": "string", "description": "API-Football fixture id." } }, "description": "Supply an exact id or enough team/date information to resolve exactly one fixture. Multiple supplied selectors are conjunctive. Ambiguous requests return candidates and do not call a provider." }, "sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref1": { "type": "object", "required": [ "code" ], "properties": { "code": { "type": "integer", "description": "Mirrors the HTTP status code." } }, "description": "Platform-owned envelope metadata." }, "sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref2": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref3" }, { "type": "object", "required": [ "event_context", "event_urn", "resolved_fixture", "candidates" ], "properties": { "event_urn": { "type": "string" }, "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref6" } }, "event_context": { "type": "object", "required": [ "event", "result_details", "sports_context", "context_coverage" ], "properties": { "event": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref10" }, "social_pulse": { "type": "object" }, "result_details": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref7" }, "sports_context": { "type": "object", "required": [ "status", "mode", "result_details", "final_group_standings" ] }, "context_coverage": { "type": "object", "required": [ "sports_context", "prematch_research", "social_pulse", "reason" ] }, "prematch_research": { "type": "object" } } }, "resolved_fixture": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref6" } } } ] }, "sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref3": { "type": "object", "required": [ "archive", "coverage", "warnings" ], "properties": { "archive": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref4" }, "coverage": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref5" }, "warnings": { "type": "array", "items": { "type": "string" } } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref4": { "type": "object", "required": [ "mode", "version", "status", "competition", "competition_status", "live", "snapshot_as_of", "capability_status", "provenance", "missing_capabilities", "notes" ], "properties": { "live": { "const": false }, "mode": { "const": "final_archive" }, "notes": { "type": "array", "items": { "type": "string" } }, "status": { "enum": [ "hit", "miss", "unavailable", "error" ], "type": "string", "description": "hit = an immutable archived row was served. unavailable/error = nothing was served; see coverage.reason_code. A `miss` never reaches the public surface." }, "version": { "enum": [ "world-cup-2026-final-v2", "world-cup-2026-final-v3" ], "type": "string" }, "provenance": { "type": "array", "items": { "type": "string" } }, "competition": { "const": "FIFA World Cup 2026" }, "reason_code": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string" }, "snapshot_as_of": { "type": [ "string", "null" ] }, "response_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "capability_status": { "type": "string" }, "competition_status": { "const": "completed" }, "content_created_at": { "type": [ "string", "null" ] }, "source_observed_at": { "type": [ "string", "null" ] }, "timestamp_semantics": { "type": "string" }, "missing_capabilities": { "type": "array", "items": { "type": "string" } }, "source_manifest_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "request_identity_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref5": { "type": "object", "required": [ "schema_version", "status", "reason", "scope", "mode", "source_provenance", "population_count", "eligible_count", "included_count", "excluded_count", "exclusion_reasons", "unsupported_fields" ], "properties": { "mode": { "const": "historical" }, "scope": { "const": "completed_tournament_archive" }, "reason": { "type": "string", "minLength": 1 }, "status": { "enum": [ "complete", "partial", "unavailable", "error" ], "type": "string" }, "reason_code": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string", "description": "Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed." }, "eligible_count": { "type": [ "integer", "null" ], "minimum": 0 }, "excluded_count": { "type": [ "integer", "null" ], "minimum": 0 }, "included_count": { "type": [ "integer", "null" ], "minimum": 0 }, "schema_version": { "const": "worldcup-storefront-coverage-v1" }, "accepted_fields": { "type": "array", "items": { "type": "string" }, "description": "The request fields this endpoint accepts, echoed on unserved responses so an agent can self-correct." }, "population_count": { "type": [ "integer", "null" ], "minimum": 0, "description": "Null means the legacy response did not record this count; null is never equivalent to zero." }, "exclusion_reasons": { "type": "object", "additionalProperties": { "type": "integer", "minimum": 0 } }, "source_provenance": { "type": "array", "items": { "type": "string" } }, "unsupported_fields": { "type": "array", "items": { "type": "string" } } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref6": { "type": "object", "required": [ "event_urn", "name", "start_date", "status", "teams", "fixture_id" ], "properties": { "name": { "type": "string" }, "round": { "type": [ "string", "null" ] }, "score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref8" }, "stage": { "type": [ "string", "null" ] }, "teams": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref9" }, "minItems": 2 }, "venue": { "type": [ "string", "null" ] }, "status": { "type": "string" }, "event_urn": { "type": "string" }, "fixture_id": { "type": [ "string", "integer" ] }, "start_date": { "type": "string" }, "competition": { "type": "string" }, "result_details": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref7" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref7": { "type": "object", "required": [ "schema_version", "fixture_id", "status", "regulation_time_score", "extra_time_score_contribution", "shootout_score", "winner", "provenance" ], "properties": { "status": { "enum": [ "FT", "AET", "PEN" ], "type": "string" }, "winner": { "type": [ "object", "null" ], "properties": { "name": { "type": "string" }, "team_id": { "type": "string" }, "qualifier": { "type": "string" } } }, "fixture_id": { "type": "string" }, "provenance": { "type": "object", "required": [ "provider", "fixture_id", "provider_result_sha256", "source_url", "observed_at" ], "properties": { "provider": { "type": "string" }, "fixture_id": { "type": "string" }, "source_url": { "type": "string", "format": "uri" }, "observed_at": { "type": [ "string", "null" ] }, "provider_result_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "schema_version": { "const": "worldcup-result-details-v1" }, "shootout_score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref8" }, "regulation_time_score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref8" }, "extra_time_score_contribution": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref8" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref8": { "type": [ "object", "null" ], "properties": { "away": { "type": "integer", "minimum": 0 }, "home": { "type": "integer", "minimum": 0 }, "elapsed": { "type": "number", "minimum": 0 } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref9": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string" }, "crest": { "type": [ "string", "null" ] }, "team_urn": { "type": [ "string", "null" ] }, "qualifier": { "type": "string" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref10": { "type": "object", "properties": { "@id": { "type": [ "string", "null" ] }, "_id": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "player_key": { "type": "string" }, "provider_ids": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref12" }, "provider_id_aliases": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "string" } } }, "official_registration": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref11" }, "identity_mapping_status": { "enum": [ "canonical", "official_reconciled", "provider_only", "quarantined" ], "type": "string" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref11": { "type": "object", "required": [ "status", "source_url", "source_sha256", "published_at", "source_page", "team_name", "fifa_team_code", "jersey_number", "player_name_raw", "birth_date", "position_code", "warnings", "canonical_birth_date_conflict" ], "properties": { "source": { "const": "FIFA" }, "status": { "const": "verified_final_published_snapshot" }, "club_raw": { "type": [ "string", "null" ] }, "warnings": { "type": "array", "items": { "type": "string" } }, "height_cm": { "type": "integer" }, "team_name": { "type": "string" }, "birth_date": { "type": "string", "format": "date" }, "scope_note": { "type": "string" }, "source_url": { "type": "string", "format": "uri" }, "source_page": { "type": "integer", "maximum": 48, "minimum": 1 }, "published_at": { "type": "string", "format": "date-time" }, "jersey_number": { "type": "integer", "maximum": 26, "minimum": 1 }, "position_code": { "enum": [ "GK", "DF", "MF", "FW" ] }, "source_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "fifa_team_code": { "type": "string" }, "last_names_raw": { "type": "string" }, "shirt_name_raw": { "type": "string" }, "first_names_raw": { "type": "string" }, "player_name_raw": { "type": "string" }, "canonical_birth_date": { "type": [ "string", "null" ] }, "canonical_birth_date_conflict": { "type": "boolean" }, "international_caps_as_reported": { "type": "integer" }, "international_goals_as_reported": { "type": "integer" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref12": { "type": "object", "additionalProperties": { "type": [ "string", "integer", "null" ] } }, "sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref13": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref3" }, { "type": "object", "properties": { "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref6" } } } } ] }, "sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref14": { "type": "object", "required": [ "meta", "status", "data", "error" ], "properties": { "data": { "type": "object", "description": "Always empty on an error." }, "meta": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref1" } ] }, "error": { "type": "object", "required": [ "code", "message" ], "properties": { "code": { "type": "integer", "description": "Mirrors the HTTP status code." }, "type": { "enum": [ "selector_required", "selector_ambiguous", "unsupported_parameter", "not_found", "capability_unavailable", "archive_error" ], "type": "string", "description": "Gateway classification of an unserved answer (absent on auth/credit errors)." }, "billed": { "const": false, "description": "Always false on an unserved answer: no credit debit, no ZeroClick usage." }, "archive": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref4" }, "message": { "type": "string" }, "coverage": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref5" }, "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref6" }, "description": "Fixtures that matched an ambiguous selector." }, "top_up_url": { "type": "string", "description": "On 402 only: where to buy credits." }, "reason_code": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref15" }, "accepted_fields": { "type": "array", "items": { "type": "string" }, "description": "Request fields the endpoint accepts; use them to correct the call." } } }, "status": { "const": "error" } }, "description": "Transport envelope of every non-2xx answer (machina-client-api core/worldcup/gateway.py). Unserved archived answers (selector missing or ambiguous, unknown fixture, unsupported parameter, capability gap) are typed here and are never billed." }, "sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref15": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string", "description": "Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed." }, "sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref0": { "type": "object", "anyOf": [ { "required": [ "event_urn" ] }, { "required": [ "provider_event_id" ] }, { "required": [ "event" ] }, { "required": [ "team" ] } ], "properties": { "date": { "type": "string", "format": "date", "description": "Fixture date, YYYY-MM-DD." }, "team": { "type": "string", "description": "One team name." }, "event": { "type": "string", "description": "Fixture label such as Brazil vs Morocco." }, "opponent": { "type": "string", "description": "Opponent name used to disambiguate." }, "event_urn": { "type": "string", "description": "Canonical event URN." }, "provider_event_id": { "type": "string", "description": "API-Football fixture id." } }, "description": "Supply an exact id or enough team/date information to resolve exactly one fixture. Multiple supplied selectors are conjunctive. Ambiguous requests return candidates and do not call a provider." }, "sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref1": { "type": "object", "required": [ "code" ], "properties": { "code": { "type": "integer", "description": "Mirrors the HTTP status code." } }, "description": "Platform-owned envelope metadata." }, "sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref2": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref3" }, { "type": "object", "required": [ "injuries", "candidates" ], "properties": { "injuries": { "type": "object", "required": [ "source", "teams", "evidence_status", "observed_record_count", "historical_completeness_verified" ], "properties": { "teams": { "type": "array", "items": { "type": "object", "required": [ "side", "count", "missing" ] } }, "source": { "type": "string" }, "evidence_status": { "enum": [ "recorded_absences", "confirmed_none", "unavailable" ] }, "observed_record_count": { "type": "integer", "minimum": 0 }, "historical_completeness_verified": { "type": "boolean" } } }, "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref6" } } } } ] }, "sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref3": { "type": "object", "required": [ "archive", "coverage", "warnings" ], "properties": { "archive": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref4" }, "coverage": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref5" }, "warnings": { "type": "array", "items": { "type": "string" } } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref4": { "type": "object", "required": [ "mode", "version", "status", "competition", "competition_status", "live", "snapshot_as_of", "capability_status", "provenance", "missing_capabilities", "notes" ], "properties": { "live": { "const": false }, "mode": { "const": "final_archive" }, "notes": { "type": "array", "items": { "type": "string" } }, "status": { "enum": [ "hit", "miss", "unavailable", "error" ], "type": "string", "description": "hit = an immutable archived row was served. unavailable/error = nothing was served; see coverage.reason_code. A `miss` never reaches the public surface." }, "version": { "enum": [ "world-cup-2026-final-v2", "world-cup-2026-final-v3" ], "type": "string" }, "provenance": { "type": "array", "items": { "type": "string" } }, "competition": { "const": "FIFA World Cup 2026" }, "reason_code": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string" }, "snapshot_as_of": { "type": [ "string", "null" ] }, "response_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "capability_status": { "type": "string" }, "competition_status": { "const": "completed" }, "content_created_at": { "type": [ "string", "null" ] }, "source_observed_at": { "type": [ "string", "null" ] }, "timestamp_semantics": { "type": "string" }, "missing_capabilities": { "type": "array", "items": { "type": "string" } }, "source_manifest_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "request_identity_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref5": { "type": "object", "required": [ "schema_version", "status", "reason", "scope", "mode", "source_provenance", "population_count", "eligible_count", "included_count", "excluded_count", "exclusion_reasons", "unsupported_fields" ], "properties": { "mode": { "const": "historical" }, "scope": { "const": "completed_tournament_archive" }, "reason": { "type": "string", "minLength": 1 }, "status": { "enum": [ "complete", "partial", "unavailable", "error" ], "type": "string" }, "reason_code": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string", "description": "Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed." }, "eligible_count": { "type": [ "integer", "null" ], "minimum": 0 }, "excluded_count": { "type": [ "integer", "null" ], "minimum": 0 }, "included_count": { "type": [ "integer", "null" ], "minimum": 0 }, "schema_version": { "const": "worldcup-storefront-coverage-v1" }, "accepted_fields": { "type": "array", "items": { "type": "string" }, "description": "The request fields this endpoint accepts, echoed on unserved responses so an agent can self-correct." }, "population_count": { "type": [ "integer", "null" ], "minimum": 0, "description": "Null means the legacy response did not record this count; null is never equivalent to zero." }, "exclusion_reasons": { "type": "object", "additionalProperties": { "type": "integer", "minimum": 0 } }, "source_provenance": { "type": "array", "items": { "type": "string" } }, "unsupported_fields": { "type": "array", "items": { "type": "string" } } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref6": { "type": "object", "required": [ "event_urn", "name", "start_date", "status", "teams", "fixture_id" ], "properties": { "name": { "type": "string" }, "round": { "type": [ "string", "null" ] }, "score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref8" }, "stage": { "type": [ "string", "null" ] }, "teams": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref9" }, "minItems": 2 }, "venue": { "type": [ "string", "null" ] }, "status": { "type": "string" }, "event_urn": { "type": "string" }, "fixture_id": { "type": [ "string", "integer" ] }, "start_date": { "type": "string" }, "competition": { "type": "string" }, "result_details": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref7" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref7": { "type": "object", "required": [ "schema_version", "fixture_id", "status", "regulation_time_score", "extra_time_score_contribution", "shootout_score", "winner", "provenance" ], "properties": { "status": { "enum": [ "FT", "AET", "PEN" ], "type": "string" }, "winner": { "type": [ "object", "null" ], "properties": { "name": { "type": "string" }, "team_id": { "type": "string" }, "qualifier": { "type": "string" } } }, "fixture_id": { "type": "string" }, "provenance": { "type": "object", "required": [ "provider", "fixture_id", "provider_result_sha256", "source_url", "observed_at" ], "properties": { "provider": { "type": "string" }, "fixture_id": { "type": "string" }, "source_url": { "type": "string", "format": "uri" }, "observed_at": { "type": [ "string", "null" ] }, "provider_result_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "schema_version": { "const": "worldcup-result-details-v1" }, "shootout_score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref8" }, "regulation_time_score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref8" }, "extra_time_score_contribution": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref8" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref8": { "type": [ "object", "null" ], "properties": { "away": { "type": "integer", "minimum": 0 }, "home": { "type": "integer", "minimum": 0 }, "elapsed": { "type": "number", "minimum": 0 } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref9": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string" }, "crest": { "type": [ "string", "null" ] }, "team_urn": { "type": [ "string", "null" ] }, "qualifier": { "type": "string" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref10": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref3" }, { "type": "object", "properties": { "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref6" } } } } ] }, "sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref11": { "type": "object", "required": [ "meta", "status", "data", "error" ], "properties": { "data": { "type": "object", "description": "Always empty on an error." }, "meta": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref1" } ] }, "error": { "type": "object", "required": [ "code", "message" ], "properties": { "code": { "type": "integer", "description": "Mirrors the HTTP status code." }, "type": { "enum": [ "selector_required", "selector_ambiguous", "unsupported_parameter", "not_found", "capability_unavailable", "archive_error" ], "type": "string", "description": "Gateway classification of an unserved answer (absent on auth/credit errors)." }, "billed": { "const": false, "description": "Always false on an unserved answer: no credit debit, no ZeroClick usage." }, "archive": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref4" }, "message": { "type": "string" }, "coverage": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref5" }, "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref6" }, "description": "Fixtures that matched an ambiguous selector." }, "top_up_url": { "type": "string", "description": "On 402 only: where to buy credits." }, "reason_code": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref12" }, "accepted_fields": { "type": "array", "items": { "type": "string" }, "description": "Request fields the endpoint accepts; use them to correct the call." } } }, "status": { "const": "error" } }, "description": "Transport envelope of every non-2xx answer (machina-client-api core/worldcup/gateway.py). Unserved archived answers (selector missing or ambiguous, unknown fixture, unsupported parameter, capability gap) are typed here and are never billed." }, "sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref12": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string", "description": "Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed." }, "sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref0": { "type": "object", "anyOf": [ { "required": [ "event_urn" ] }, { "required": [ "provider_event_id" ] }, { "required": [ "event" ] }, { "required": [ "team" ] } ], "properties": { "date": { "type": "string", "format": "date", "description": "Fixture date, YYYY-MM-DD." }, "team": { "type": "string", "description": "One team name." }, "event": { "type": "string", "description": "Fixture label such as Brazil vs Morocco." }, "opponent": { "type": "string", "description": "Opponent name used to disambiguate." }, "event_urn": { "type": "string", "description": "Canonical event URN." }, "provider_event_id": { "type": "string", "description": "API-Football fixture id." } }, "description": "Supply an exact id or enough team/date information to resolve exactly one fixture. Multiple supplied selectors are conjunctive. Ambiguous requests return candidates and do not call a provider." }, "sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref1": { "type": "object", "required": [ "code" ], "properties": { "code": { "type": "integer", "description": "Mirrors the HTTP status code." } }, "description": "Platform-owned envelope metadata." }, "sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref2": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref3" }, { "type": "object", "required": [ "forecast", "forecast_integrity", "market_integrity", "model_vs_market", "candidates" ], "properties": { "analysis": { "type": "object" }, "forecast": { "type": "object", "required": [ "model", "probabilities" ], "properties": { "model": { "type": "object", "required": [ "computed_at" ] }, "caveats": { "type": "array", "items": { "type": "string" } }, "confidence": { "type": "number", "maximum": 1, "minimum": 0, "description": "Model self-assessed confidence in [0,1]; 0.15 for seed-only forecasts." }, "data_source": { "enum": [ "seed", "blend", "results" ], "type": "string", "description": "How the pre-kickoff model was fed. seed = no FIFA World Cup 2026 result existed yet for at least one side, so the model used the FIFA-ranking seed prior (typical for every team's first match; confidence 0.15). blend = tournament results blended with the seed prior (confidence rises with games played). results = fitted on tournament results only. A seed forecast is the intended archived answer, not a placeholder; archive.notes carries the same explanation on every forecast hit." }, "probabilities": { "type": "object", "required": [ "home_win", "draw", "away_win" ] }, "away_expected_goals": { "type": "number" }, "home_expected_goals": { "type": "number" } }, "description": "The model's ORIGINAL pre-kickoff Dixon-Coles forecast, preserved exactly as it was computed before the match. Nothing is recomputed at request time and no post-match information leaks in; forecast_integrity states whether the stored timestamp is genuinely pre-kickoff." }, "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref6" } }, "model_vs_market": { "type": "object", "required": [ "comparison_status", "gaps" ] }, "market_integrity": { "type": "object", "required": [ "classification" ] }, "forecast_integrity": { "type": "object", "required": [ "verified_pre_kickoff" ] } } } ] }, "sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref3": { "type": "object", "required": [ "archive", "coverage", "warnings" ], "properties": { "archive": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref4" }, "coverage": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref5" }, "warnings": { "type": "array", "items": { "type": "string" } } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref4": { "type": "object", "required": [ "mode", "version", "status", "competition", "competition_status", "live", "snapshot_as_of", "capability_status", "provenance", "missing_capabilities", "notes" ], "properties": { "live": { "const": false }, "mode": { "const": "final_archive" }, "notes": { "type": "array", "items": { "type": "string" } }, "status": { "enum": [ "hit", "miss", "unavailable", "error" ], "type": "string", "description": "hit = an immutable archived row was served. unavailable/error = nothing was served; see coverage.reason_code. A `miss` never reaches the public surface." }, "version": { "enum": [ "world-cup-2026-final-v2", "world-cup-2026-final-v3" ], "type": "string" }, "provenance": { "type": "array", "items": { "type": "string" } }, "competition": { "const": "FIFA World Cup 2026" }, "reason_code": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string" }, "snapshot_as_of": { "type": [ "string", "null" ] }, "response_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "capability_status": { "type": "string" }, "competition_status": { "const": "completed" }, "content_created_at": { "type": [ "string", "null" ] }, "source_observed_at": { "type": [ "string", "null" ] }, "timestamp_semantics": { "type": "string" }, "missing_capabilities": { "type": "array", "items": { "type": "string" } }, "source_manifest_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "request_identity_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref5": { "type": "object", "required": [ "schema_version", "status", "reason", "scope", "mode", "source_provenance", "population_count", "eligible_count", "included_count", "excluded_count", "exclusion_reasons", "unsupported_fields" ], "properties": { "mode": { "const": "historical" }, "scope": { "const": "completed_tournament_archive" }, "reason": { "type": "string", "minLength": 1 }, "status": { "enum": [ "complete", "partial", "unavailable", "error" ], "type": "string" }, "reason_code": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string", "description": "Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed." }, "eligible_count": { "type": [ "integer", "null" ], "minimum": 0 }, "excluded_count": { "type": [ "integer", "null" ], "minimum": 0 }, "included_count": { "type": [ "integer", "null" ], "minimum": 0 }, "schema_version": { "const": "worldcup-storefront-coverage-v1" }, "accepted_fields": { "type": "array", "items": { "type": "string" }, "description": "The request fields this endpoint accepts, echoed on unserved responses so an agent can self-correct." }, "population_count": { "type": [ "integer", "null" ], "minimum": 0, "description": "Null means the legacy response did not record this count; null is never equivalent to zero." }, "exclusion_reasons": { "type": "object", "additionalProperties": { "type": "integer", "minimum": 0 } }, "source_provenance": { "type": "array", "items": { "type": "string" } }, "unsupported_fields": { "type": "array", "items": { "type": "string" } } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref6": { "type": "object", "required": [ "event_urn", "name", "start_date", "status", "teams", "fixture_id" ], "properties": { "name": { "type": "string" }, "round": { "type": [ "string", "null" ] }, "score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref8" }, "stage": { "type": [ "string", "null" ] }, "teams": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref9" }, "minItems": 2 }, "venue": { "type": [ "string", "null" ] }, "status": { "type": "string" }, "event_urn": { "type": "string" }, "fixture_id": { "type": [ "string", "integer" ] }, "start_date": { "type": "string" }, "competition": { "type": "string" }, "result_details": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref7" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref7": { "type": "object", "required": [ "schema_version", "fixture_id", "status", "regulation_time_score", "extra_time_score_contribution", "shootout_score", "winner", "provenance" ], "properties": { "status": { "enum": [ "FT", "AET", "PEN" ], "type": "string" }, "winner": { "type": [ "object", "null" ], "properties": { "name": { "type": "string" }, "team_id": { "type": "string" }, "qualifier": { "type": "string" } } }, "fixture_id": { "type": "string" }, "provenance": { "type": "object", "required": [ "provider", "fixture_id", "provider_result_sha256", "source_url", "observed_at" ], "properties": { "provider": { "type": "string" }, "fixture_id": { "type": "string" }, "source_url": { "type": "string", "format": "uri" }, "observed_at": { "type": [ "string", "null" ] }, "provider_result_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "schema_version": { "const": "worldcup-result-details-v1" }, "shootout_score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref8" }, "regulation_time_score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref8" }, "extra_time_score_contribution": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref8" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref8": { "type": [ "object", "null" ], "properties": { "away": { "type": "integer", "minimum": 0 }, "home": { "type": "integer", "minimum": 0 }, "elapsed": { "type": "number", "minimum": 0 } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref9": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string" }, "crest": { "type": [ "string", "null" ] }, "team_urn": { "type": [ "string", "null" ] }, "qualifier": { "type": "string" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref10": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref3" }, { "type": "object", "properties": { "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref6" } } } } ] }, "sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref11": { "type": "object", "required": [ "meta", "status", "data", "error" ], "properties": { "data": { "type": "object", "description": "Always empty on an error." }, "meta": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref1" } ] }, "error": { "type": "object", "required": [ "code", "message" ], "properties": { "code": { "type": "integer", "description": "Mirrors the HTTP status code." }, "type": { "enum": [ "selector_required", "selector_ambiguous", "unsupported_parameter", "not_found", "capability_unavailable", "archive_error" ], "type": "string", "description": "Gateway classification of an unserved answer (absent on auth/credit errors)." }, "billed": { "const": false, "description": "Always false on an unserved answer: no credit debit, no ZeroClick usage." }, "archive": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref4" }, "message": { "type": "string" }, "coverage": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref5" }, "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref6" }, "description": "Fixtures that matched an ambiguous selector." }, "top_up_url": { "type": "string", "description": "On 402 only: where to buy credits." }, "reason_code": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref12" }, "accepted_fields": { "type": "array", "items": { "type": "string" }, "description": "Request fields the endpoint accepts; use them to correct the call." } } }, "status": { "const": "error" } }, "description": "Transport envelope of every non-2xx answer (machina-client-api core/worldcup/gateway.py). Unserved archived answers (selector missing or ambiguous, unknown fixture, unsupported parameter, capability gap) are typed here and are never billed." }, "sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref12": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string", "description": "Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed." }, "sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref0": { "type": "object", "anyOf": [ { "required": [ "event_urn" ] }, { "required": [ "provider_event_id" ] }, { "required": [ "event" ] }, { "required": [ "team" ] } ], "properties": { "date": { "type": "string", "format": "date", "description": "Fixture date, YYYY-MM-DD." }, "team": { "type": "string", "description": "One team name." }, "event": { "type": "string", "description": "Fixture label such as Brazil vs Morocco." }, "opponent": { "type": "string", "description": "Opponent name used to disambiguate." }, "event_urn": { "type": "string", "description": "Canonical event URN." }, "provider_event_id": { "type": "string", "description": "API-Football fixture id." } }, "description": "Supply an exact id or enough team/date information to resolve exactly one fixture. Multiple supplied selectors are conjunctive. Ambiguous requests return candidates and do not call a provider." }, "sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref1": { "type": "object", "required": [ "code" ], "properties": { "code": { "type": "integer", "description": "Mirrors the HTTP status code." } }, "description": "Platform-owned envelope metadata." }, "sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref2": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref3" }, { "type": "object", "required": [ "fixture_player_pack", "status", "identity_coverage" ], "properties": { "status": { "type": "string" }, "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref6" } }, "identity_coverage": { "type": "object", "required": [ "canonical_count", "provider_only_count", "ambiguous_omitted_count" ] }, "player_candidates": { "type": "array", "items": { "type": "object" } }, "fixture_player_pack": { "type": "object", "required": [ "event_urn", "fixture_id", "player_count" ], "properties": { "players": { "type": "array" }, "raw_player_count": { "type": "integer", "minimum": 0 } } }, "player_performance_context": { "type": "object" } } } ] }, "sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref3": { "type": "object", "required": [ "archive", "coverage", "warnings" ], "properties": { "archive": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref4" }, "coverage": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref5" }, "warnings": { "type": "array", "items": { "type": "string" } } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref4": { "type": "object", "required": [ "mode", "version", "status", "competition", "competition_status", "live", "snapshot_as_of", "capability_status", "provenance", "missing_capabilities", "notes" ], "properties": { "live": { "const": false }, "mode": { "const": "final_archive" }, "notes": { "type": "array", "items": { "type": "string" } }, "status": { "enum": [ "hit", "miss", "unavailable", "error" ], "type": "string", "description": "hit = an immutable archived row was served. unavailable/error = nothing was served; see coverage.reason_code. A `miss` never reaches the public surface." }, "version": { "enum": [ "world-cup-2026-final-v2", "world-cup-2026-final-v3" ], "type": "string" }, "provenance": { "type": "array", "items": { "type": "string" } }, "competition": { "const": "FIFA World Cup 2026" }, "reason_code": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string" }, "snapshot_as_of": { "type": [ "string", "null" ] }, "response_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "capability_status": { "type": "string" }, "competition_status": { "const": "completed" }, "content_created_at": { "type": [ "string", "null" ] }, "source_observed_at": { "type": [ "string", "null" ] }, "timestamp_semantics": { "type": "string" }, "missing_capabilities": { "type": "array", "items": { "type": "string" } }, "source_manifest_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "request_identity_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref5": { "type": "object", "required": [ "schema_version", "status", "reason", "scope", "mode", "source_provenance", "population_count", "eligible_count", "included_count", "excluded_count", "exclusion_reasons", "unsupported_fields" ], "properties": { "mode": { "const": "historical" }, "scope": { "const": "completed_tournament_archive" }, "reason": { "type": "string", "minLength": 1 }, "status": { "enum": [ "complete", "partial", "unavailable", "error" ], "type": "string" }, "reason_code": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string", "description": "Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed." }, "eligible_count": { "type": [ "integer", "null" ], "minimum": 0 }, "excluded_count": { "type": [ "integer", "null" ], "minimum": 0 }, "included_count": { "type": [ "integer", "null" ], "minimum": 0 }, "schema_version": { "const": "worldcup-storefront-coverage-v1" }, "accepted_fields": { "type": "array", "items": { "type": "string" }, "description": "The request fields this endpoint accepts, echoed on unserved responses so an agent can self-correct." }, "population_count": { "type": [ "integer", "null" ], "minimum": 0, "description": "Null means the legacy response did not record this count; null is never equivalent to zero." }, "exclusion_reasons": { "type": "object", "additionalProperties": { "type": "integer", "minimum": 0 } }, "source_provenance": { "type": "array", "items": { "type": "string" } }, "unsupported_fields": { "type": "array", "items": { "type": "string" } } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref6": { "type": "object", "required": [ "event_urn", "name", "start_date", "status", "teams", "fixture_id" ], "properties": { "name": { "type": "string" }, "round": { "type": [ "string", "null" ] }, "score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref8" }, "stage": { "type": [ "string", "null" ] }, "teams": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref9" }, "minItems": 2 }, "venue": { "type": [ "string", "null" ] }, "status": { "type": "string" }, "event_urn": { "type": "string" }, "fixture_id": { "type": [ "string", "integer" ] }, "start_date": { "type": "string" }, "competition": { "type": "string" }, "result_details": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref7" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref7": { "type": "object", "required": [ "schema_version", "fixture_id", "status", "regulation_time_score", "extra_time_score_contribution", "shootout_score", "winner", "provenance" ], "properties": { "status": { "enum": [ "FT", "AET", "PEN" ], "type": "string" }, "winner": { "type": [ "object", "null" ], "properties": { "name": { "type": "string" }, "team_id": { "type": "string" }, "qualifier": { "type": "string" } } }, "fixture_id": { "type": "string" }, "provenance": { "type": "object", "required": [ "provider", "fixture_id", "provider_result_sha256", "source_url", "observed_at" ], "properties": { "provider": { "type": "string" }, "fixture_id": { "type": "string" }, "source_url": { "type": "string", "format": "uri" }, "observed_at": { "type": [ "string", "null" ] }, "provider_result_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "schema_version": { "const": "worldcup-result-details-v1" }, "shootout_score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref8" }, "regulation_time_score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref8" }, "extra_time_score_contribution": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref8" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref8": { "type": [ "object", "null" ], "properties": { "away": { "type": "integer", "minimum": 0 }, "home": { "type": "integer", "minimum": 0 }, "elapsed": { "type": "number", "minimum": 0 } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref9": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string" }, "crest": { "type": [ "string", "null" ] }, "team_urn": { "type": [ "string", "null" ] }, "qualifier": { "type": "string" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref10": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref3" }, { "type": "object", "properties": { "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref6" } } } } ] }, "sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref11": { "type": "object", "required": [ "meta", "status", "data", "error" ], "properties": { "data": { "type": "object", "description": "Always empty on an error." }, "meta": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref1" } ] }, "error": { "type": "object", "required": [ "code", "message" ], "properties": { "code": { "type": "integer", "description": "Mirrors the HTTP status code." }, "type": { "enum": [ "selector_required", "selector_ambiguous", "unsupported_parameter", "not_found", "capability_unavailable", "archive_error" ], "type": "string", "description": "Gateway classification of an unserved answer (absent on auth/credit errors)." }, "billed": { "const": false, "description": "Always false on an unserved answer: no credit debit, no ZeroClick usage." }, "archive": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref4" }, "message": { "type": "string" }, "coverage": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref5" }, "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref6" }, "description": "Fixtures that matched an ambiguous selector." }, "top_up_url": { "type": "string", "description": "On 402 only: where to buy credits." }, "reason_code": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref12" }, "accepted_fields": { "type": "array", "items": { "type": "string" }, "description": "Request fields the endpoint accepts; use them to correct the call." } } }, "status": { "const": "error" } }, "description": "Transport envelope of every non-2xx answer (machina-client-api core/worldcup/gateway.py). Unserved archived answers (selector missing or ambiguous, unknown fixture, unsupported parameter, capability gap) are typed here and are never billed." }, "sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref12": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string", "description": "Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed." }, "sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref0": { "type": "object", "required": [ "code" ], "properties": { "code": { "type": "integer", "description": "Mirrors the HTTP status code." } }, "description": "Platform-owned envelope metadata." }, "sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref1": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref2" }, { "type": "object", "required": [ "schedule" ], "properties": { "schedule": { "type": "object", "required": [ "events", "count", "total_count", "offset", "limit", "has_more", "truncated" ], "properties": { "count": { "type": "integer" }, "limit": { "type": "integer" }, "events": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref5" } }, "offset": { "type": "integer" }, "has_more": { "type": "boolean" }, "warnings": { "type": "array", "items": { "type": "string" } }, "truncated": { "type": "boolean" }, "total_count": { "type": "integer" } } } } } ] }, "sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref2": { "type": "object", "required": [ "archive", "coverage", "warnings" ], "properties": { "archive": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref3" }, "coverage": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref4" }, "warnings": { "type": "array", "items": { "type": "string" } } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref3": { "type": "object", "required": [ "mode", "version", "status", "competition", "competition_status", "live", "snapshot_as_of", "capability_status", "provenance", "missing_capabilities", "notes" ], "properties": { "live": { "const": false }, "mode": { "const": "final_archive" }, "notes": { "type": "array", "items": { "type": "string" } }, "status": { "enum": [ "hit", "miss", "unavailable", "error" ], "type": "string", "description": "hit = an immutable archived row was served. unavailable/error = nothing was served; see coverage.reason_code. A `miss` never reaches the public surface." }, "version": { "enum": [ "world-cup-2026-final-v2", "world-cup-2026-final-v3" ], "type": "string" }, "provenance": { "type": "array", "items": { "type": "string" } }, "competition": { "const": "FIFA World Cup 2026" }, "reason_code": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string" }, "snapshot_as_of": { "type": [ "string", "null" ] }, "response_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "capability_status": { "type": "string" }, "competition_status": { "const": "completed" }, "content_created_at": { "type": [ "string", "null" ] }, "source_observed_at": { "type": [ "string", "null" ] }, "timestamp_semantics": { "type": "string" }, "missing_capabilities": { "type": "array", "items": { "type": "string" } }, "source_manifest_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "request_identity_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref4": { "type": "object", "required": [ "schema_version", "status", "reason", "scope", "mode", "source_provenance", "population_count", "eligible_count", "included_count", "excluded_count", "exclusion_reasons", "unsupported_fields" ], "properties": { "mode": { "const": "historical" }, "scope": { "const": "completed_tournament_archive" }, "reason": { "type": "string", "minLength": 1 }, "status": { "enum": [ "complete", "partial", "unavailable", "error" ], "type": "string" }, "reason_code": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string", "description": "Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed." }, "eligible_count": { "type": [ "integer", "null" ], "minimum": 0 }, "excluded_count": { "type": [ "integer", "null" ], "minimum": 0 }, "included_count": { "type": [ "integer", "null" ], "minimum": 0 }, "schema_version": { "const": "worldcup-storefront-coverage-v1" }, "accepted_fields": { "type": "array", "items": { "type": "string" }, "description": "The request fields this endpoint accepts, echoed on unserved responses so an agent can self-correct." }, "population_count": { "type": [ "integer", "null" ], "minimum": 0, "description": "Null means the legacy response did not record this count; null is never equivalent to zero." }, "exclusion_reasons": { "type": "object", "additionalProperties": { "type": "integer", "minimum": 0 } }, "source_provenance": { "type": "array", "items": { "type": "string" } }, "unsupported_fields": { "type": "array", "items": { "type": "string" } } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref5": { "type": "object", "required": [ "event_urn", "name", "start_date", "status", "teams", "fixture_id" ], "properties": { "name": { "type": "string" }, "round": { "type": [ "string", "null" ] }, "score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref7" }, "stage": { "type": [ "string", "null" ] }, "teams": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref8" }, "minItems": 2 }, "venue": { "type": [ "string", "null" ] }, "status": { "type": "string" }, "event_urn": { "type": "string" }, "fixture_id": { "type": [ "string", "integer" ] }, "start_date": { "type": "string" }, "competition": { "type": "string" }, "result_details": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref6" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref6": { "type": "object", "required": [ "schema_version", "fixture_id", "status", "regulation_time_score", "extra_time_score_contribution", "shootout_score", "winner", "provenance" ], "properties": { "status": { "enum": [ "FT", "AET", "PEN" ], "type": "string" }, "winner": { "type": [ "object", "null" ], "properties": { "name": { "type": "string" }, "team_id": { "type": "string" }, "qualifier": { "type": "string" } } }, "fixture_id": { "type": "string" }, "provenance": { "type": "object", "required": [ "provider", "fixture_id", "provider_result_sha256", "source_url", "observed_at" ], "properties": { "provider": { "type": "string" }, "fixture_id": { "type": "string" }, "source_url": { "type": "string", "format": "uri" }, "observed_at": { "type": [ "string", "null" ] }, "provider_result_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "schema_version": { "const": "worldcup-result-details-v1" }, "shootout_score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref7" }, "regulation_time_score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref7" }, "extra_time_score_contribution": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref7" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref7": { "type": [ "object", "null" ], "properties": { "away": { "type": "integer", "minimum": 0 }, "home": { "type": "integer", "minimum": 0 }, "elapsed": { "type": "number", "minimum": 0 } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref8": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string" }, "crest": { "type": [ "string", "null" ] }, "team_urn": { "type": [ "string", "null" ] }, "qualifier": { "type": "string" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref9": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref2" }, { "type": "object", "properties": { "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref5" } } } } ] }, "sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref10": { "type": "object", "required": [ "meta", "status", "data", "error" ], "properties": { "data": { "type": "object", "description": "Always empty on an error." }, "meta": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref0" } ] }, "error": { "type": "object", "required": [ "code", "message" ], "properties": { "code": { "type": "integer", "description": "Mirrors the HTTP status code." }, "type": { "enum": [ "selector_required", "selector_ambiguous", "unsupported_parameter", "not_found", "capability_unavailable", "archive_error" ], "type": "string", "description": "Gateway classification of an unserved answer (absent on auth/credit errors)." }, "billed": { "const": false, "description": "Always false on an unserved answer: no credit debit, no ZeroClick usage." }, "archive": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref3" }, "message": { "type": "string" }, "coverage": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref4" }, "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref5" }, "description": "Fixtures that matched an ambiguous selector." }, "top_up_url": { "type": "string", "description": "On 402 only: where to buy credits." }, "reason_code": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref11" }, "accepted_fields": { "type": "array", "items": { "type": "string" }, "description": "Request fields the endpoint accepts; use them to correct the call." } } }, "status": { "const": "error" } }, "description": "Transport envelope of every non-2xx answer (machina-client-api core/worldcup/gateway.py). Unserved archived answers (selector missing or ambiguous, unknown fixture, unsupported parameter, capability gap) are typed here and are never billed." }, "sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref11": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string", "description": "Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed." }, "sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref0": { "type": "object", "anyOf": [ { "required": [ "event_urn" ] }, { "required": [ "provider_event_id" ] }, { "required": [ "event" ] }, { "required": [ "team" ] } ], "properties": { "date": { "type": "string", "format": "date", "description": "Fixture date, YYYY-MM-DD." }, "team": { "type": "string", "description": "One team name." }, "event": { "type": "string", "description": "Fixture label such as Brazil vs Morocco." }, "opponent": { "type": "string", "description": "Opponent name used to disambiguate." }, "event_urn": { "type": "string", "description": "Canonical event URN." }, "provider_event_id": { "type": "string", "description": "API-Football fixture id." } }, "description": "Supply an exact id or enough team/date information to resolve exactly one fixture. Multiple supplied selectors are conjunctive. Ambiguous requests return candidates and do not call a provider." }, "sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref1": { "type": "object", "required": [ "code" ], "properties": { "code": { "type": "integer", "description": "Mirrors the HTTP status code." } }, "description": "Platform-owned envelope metadata." }, "sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref2": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref3" }, { "type": "object", "required": [ "squads", "candidates" ], "properties": { "squads": { "type": "object", "required": [ "teams", "evidence_status", "official_registration_status", "observed_player_count", "official_registration_snapshot" ], "properties": { "teams": { "type": "array", "items": { "type": "object", "required": [ "side" ] }, "minItems": 2 }, "evidence_status": { "enum": [ "observed_tournament_player_pool", "unavailable" ] }, "observed_player_count": { "type": "integer", "minimum": 0 }, "official_registration_status": { "const": "verified_final_published_snapshot" }, "official_registration_snapshot": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref10" } } }, "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref6" } } } } ] }, "sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref3": { "type": "object", "required": [ "archive", "coverage", "warnings" ], "properties": { "archive": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref4" }, "coverage": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref5" }, "warnings": { "type": "array", "items": { "type": "string" } } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref4": { "type": "object", "required": [ "mode", "version", "status", "competition", "competition_status", "live", "snapshot_as_of", "capability_status", "provenance", "missing_capabilities", "notes" ], "properties": { "live": { "const": false }, "mode": { "const": "final_archive" }, "notes": { "type": "array", "items": { "type": "string" } }, "status": { "enum": [ "hit", "miss", "unavailable", "error" ], "type": "string", "description": "hit = an immutable archived row was served. unavailable/error = nothing was served; see coverage.reason_code. A `miss` never reaches the public surface." }, "version": { "enum": [ "world-cup-2026-final-v2", "world-cup-2026-final-v3" ], "type": "string" }, "provenance": { "type": "array", "items": { "type": "string" } }, "competition": { "const": "FIFA World Cup 2026" }, "reason_code": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string" }, "snapshot_as_of": { "type": [ "string", "null" ] }, "response_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "capability_status": { "type": "string" }, "competition_status": { "const": "completed" }, "content_created_at": { "type": [ "string", "null" ] }, "source_observed_at": { "type": [ "string", "null" ] }, "timestamp_semantics": { "type": "string" }, "missing_capabilities": { "type": "array", "items": { "type": "string" } }, "source_manifest_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "request_identity_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref5": { "type": "object", "required": [ "schema_version", "status", "reason", "scope", "mode", "source_provenance", "population_count", "eligible_count", "included_count", "excluded_count", "exclusion_reasons", "unsupported_fields" ], "properties": { "mode": { "const": "historical" }, "scope": { "const": "completed_tournament_archive" }, "reason": { "type": "string", "minLength": 1 }, "status": { "enum": [ "complete", "partial", "unavailable", "error" ], "type": "string" }, "reason_code": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string", "description": "Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed." }, "eligible_count": { "type": [ "integer", "null" ], "minimum": 0 }, "excluded_count": { "type": [ "integer", "null" ], "minimum": 0 }, "included_count": { "type": [ "integer", "null" ], "minimum": 0 }, "schema_version": { "const": "worldcup-storefront-coverage-v1" }, "accepted_fields": { "type": "array", "items": { "type": "string" }, "description": "The request fields this endpoint accepts, echoed on unserved responses so an agent can self-correct." }, "population_count": { "type": [ "integer", "null" ], "minimum": 0, "description": "Null means the legacy response did not record this count; null is never equivalent to zero." }, "exclusion_reasons": { "type": "object", "additionalProperties": { "type": "integer", "minimum": 0 } }, "source_provenance": { "type": "array", "items": { "type": "string" } }, "unsupported_fields": { "type": "array", "items": { "type": "string" } } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref6": { "type": "object", "required": [ "event_urn", "name", "start_date", "status", "teams", "fixture_id" ], "properties": { "name": { "type": "string" }, "round": { "type": [ "string", "null" ] }, "score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref8" }, "stage": { "type": [ "string", "null" ] }, "teams": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref9" }, "minItems": 2 }, "venue": { "type": [ "string", "null" ] }, "status": { "type": "string" }, "event_urn": { "type": "string" }, "fixture_id": { "type": [ "string", "integer" ] }, "start_date": { "type": "string" }, "competition": { "type": "string" }, "result_details": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref7" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref7": { "type": "object", "required": [ "schema_version", "fixture_id", "status", "regulation_time_score", "extra_time_score_contribution", "shootout_score", "winner", "provenance" ], "properties": { "status": { "enum": [ "FT", "AET", "PEN" ], "type": "string" }, "winner": { "type": [ "object", "null" ], "properties": { "name": { "type": "string" }, "team_id": { "type": "string" }, "qualifier": { "type": "string" } } }, "fixture_id": { "type": "string" }, "provenance": { "type": "object", "required": [ "provider", "fixture_id", "provider_result_sha256", "source_url", "observed_at" ], "properties": { "provider": { "type": "string" }, "fixture_id": { "type": "string" }, "source_url": { "type": "string", "format": "uri" }, "observed_at": { "type": [ "string", "null" ] }, "provider_result_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "schema_version": { "const": "worldcup-result-details-v1" }, "shootout_score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref8" }, "regulation_time_score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref8" }, "extra_time_score_contribution": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref8" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref8": { "type": [ "object", "null" ], "properties": { "away": { "type": "integer", "minimum": 0 }, "home": { "type": "integer", "minimum": 0 }, "elapsed": { "type": "number", "minimum": 0 } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref9": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string" }, "crest": { "type": [ "string", "null" ] }, "team_urn": { "type": [ "string", "null" ] }, "qualifier": { "type": "string" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref10": { "type": "object", "required": [ "scope", "published_at", "source_url", "source_sha256", "snapshot_team_count", "players_per_team", "teams", "completeness", "limitations" ], "properties": { "scope": { "const": "final_published_tournament_roster_snapshot" }, "teams": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref11" }, "maxItems": 2, "minItems": 2 }, "source_url": { "type": "string", "format": "uri" }, "limitations": { "type": "array", "items": { "type": "string" } }, "completeness": { "type": "object" }, "published_at": { "type": "string", "format": "date-time" }, "source_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "players_per_team": { "const": 26 }, "snapshot_team_count": { "const": 48 } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref11": { "type": "object", "required": [ "team_name", "fifa_team_code", "source_page", "player_count", "players", "source", "completeness" ], "properties": { "source": { "type": "object", "required": [ "publisher", "url", "sha256", "published_at", "page" ] }, "players": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref12" }, "maxItems": 26, "minItems": 26 }, "team_name": { "type": "string" }, "source_page": { "type": "integer", "maximum": 48, "minimum": 1 }, "completeness": { "type": "object", "required": [ "status", "expected_players", "included_players" ] }, "player_count": { "const": 26 }, "fifa_team_code": { "type": "string" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref12": { "type": "object", "required": [ "canonical_urn", "provider_ids", "provider_id_aliases", "identity_mapping_status", "team_name", "fifa_team_code", "jersey_number", "player_name_raw", "first_names_raw", "last_names_raw", "shirt_name_raw", "birth_date", "position_code", "club_raw", "height_cm", "international_caps_as_reported", "international_goals_as_reported", "source_page", "warnings", "canonical_birth_date", "canonical_birth_date_conflict" ], "properties": { "club_raw": { "type": [ "string", "null" ] }, "warnings": { "type": "array", "items": { "type": "string" } }, "height_cm": { "type": "integer" }, "team_name": { "type": "string" }, "birth_date": { "type": "string", "format": "date" }, "source_page": { "type": "integer", "maximum": 48, "minimum": 1 }, "provider_ids": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref13" }, "canonical_urn": { "type": "string" }, "jersey_number": { "type": "integer", "maximum": 26, "minimum": 1 }, "position_code": { "enum": [ "GK", "DF", "MF", "FW" ] }, "fifa_team_code": { "type": "string" }, "last_names_raw": { "type": "string" }, "shirt_name_raw": { "type": "string" }, "first_names_raw": { "type": "string" }, "player_name_raw": { "type": "string" }, "provider_id_aliases": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "string" } } }, "canonical_birth_date": { "type": [ "string", "null" ] }, "identity_mapping_status": { "const": "official_reconciled" }, "canonical_birth_date_conflict": { "type": "boolean" }, "international_caps_as_reported": { "type": "integer" }, "international_goals_as_reported": { "type": "integer" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref13": { "type": "object", "additionalProperties": { "type": [ "string", "integer", "null" ] } }, "sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref14": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref3" }, { "type": "object", "properties": { "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref6" } } } } ] }, "sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref15": { "type": "object", "required": [ "meta", "status", "data", "error" ], "properties": { "data": { "type": "object", "description": "Always empty on an error." }, "meta": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref1" } ] }, "error": { "type": "object", "required": [ "code", "message" ], "properties": { "code": { "type": "integer", "description": "Mirrors the HTTP status code." }, "type": { "enum": [ "selector_required", "selector_ambiguous", "unsupported_parameter", "not_found", "capability_unavailable", "archive_error" ], "type": "string", "description": "Gateway classification of an unserved answer (absent on auth/credit errors)." }, "billed": { "const": false, "description": "Always false on an unserved answer: no credit debit, no ZeroClick usage." }, "archive": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref4" }, "message": { "type": "string" }, "coverage": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref5" }, "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref6" }, "description": "Fixtures that matched an ambiguous selector." }, "top_up_url": { "type": "string", "description": "On 402 only: where to buy credits." }, "reason_code": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref16" }, "accepted_fields": { "type": "array", "items": { "type": "string" }, "description": "Request fields the endpoint accepts; use them to correct the call." } } }, "status": { "const": "error" } }, "description": "Transport envelope of every non-2xx answer (machina-client-api core/worldcup/gateway.py). Unserved archived answers (selector missing or ambiguous, unknown fixture, unsupported parameter, capability gap) are typed here and are never billed." }, "sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref16": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string", "description": "Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed." }, "sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref0": { "type": "object", "required": [ "code" ], "properties": { "code": { "type": "integer", "description": "Mirrors the HTTP status code." } }, "description": "Platform-owned envelope metadata." }, "sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref1": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref2" }, { "type": "object", "required": [ "standings" ], "properties": { "standings": { "type": "object", "required": [ "groups", "group_count", "third_place_ranking", "standings_scope", "team_count", "is_final_1_to_48_ranking" ], "properties": { "groups": { "type": "array", "maxItems": 12, "minItems": 12 }, "team_count": { "const": 48 }, "group_count": { "const": 12 }, "standings_scope": { "const": "final_group_standings" }, "third_place_ranking": { "type": "array", "maxItems": 12, "minItems": 12 }, "is_final_1_to_48_ranking": { "const": false } } } } } ] }, "sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref2": { "type": "object", "required": [ "archive", "coverage", "warnings" ], "properties": { "archive": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref3" }, "coverage": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref4" }, "warnings": { "type": "array", "items": { "type": "string" } } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref3": { "type": "object", "required": [ "mode", "version", "status", "competition", "competition_status", "live", "snapshot_as_of", "capability_status", "provenance", "missing_capabilities", "notes" ], "properties": { "live": { "const": false }, "mode": { "const": "final_archive" }, "notes": { "type": "array", "items": { "type": "string" } }, "status": { "enum": [ "hit", "miss", "unavailable", "error" ], "type": "string", "description": "hit = an immutable archived row was served. unavailable/error = nothing was served; see coverage.reason_code. A `miss` never reaches the public surface." }, "version": { "enum": [ "world-cup-2026-final-v2", "world-cup-2026-final-v3" ], "type": "string" }, "provenance": { "type": "array", "items": { "type": "string" } }, "competition": { "const": "FIFA World Cup 2026" }, "reason_code": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string" }, "snapshot_as_of": { "type": [ "string", "null" ] }, "response_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "capability_status": { "type": "string" }, "competition_status": { "const": "completed" }, "content_created_at": { "type": [ "string", "null" ] }, "source_observed_at": { "type": [ "string", "null" ] }, "timestamp_semantics": { "type": "string" }, "missing_capabilities": { "type": "array", "items": { "type": "string" } }, "source_manifest_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "request_identity_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref4": { "type": "object", "required": [ "schema_version", "status", "reason", "scope", "mode", "source_provenance", "population_count", "eligible_count", "included_count", "excluded_count", "exclusion_reasons", "unsupported_fields" ], "properties": { "mode": { "const": "historical" }, "scope": { "const": "completed_tournament_archive" }, "reason": { "type": "string", "minLength": 1 }, "status": { "enum": [ "complete", "partial", "unavailable", "error" ], "type": "string" }, "reason_code": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string", "description": "Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed." }, "eligible_count": { "type": [ "integer", "null" ], "minimum": 0 }, "excluded_count": { "type": [ "integer", "null" ], "minimum": 0 }, "included_count": { "type": [ "integer", "null" ], "minimum": 0 }, "schema_version": { "const": "worldcup-storefront-coverage-v1" }, "accepted_fields": { "type": "array", "items": { "type": "string" }, "description": "The request fields this endpoint accepts, echoed on unserved responses so an agent can self-correct." }, "population_count": { "type": [ "integer", "null" ], "minimum": 0, "description": "Null means the legacy response did not record this count; null is never equivalent to zero." }, "exclusion_reasons": { "type": "object", "additionalProperties": { "type": "integer", "minimum": 0 } }, "source_provenance": { "type": "array", "items": { "type": "string" } }, "unsupported_fields": { "type": "array", "items": { "type": "string" } } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref5": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref2" }, { "type": "object", "properties": { "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref6" } } } } ] }, "sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref6": { "type": "object", "required": [ "event_urn", "name", "start_date", "status", "teams", "fixture_id" ], "properties": { "name": { "type": "string" }, "round": { "type": [ "string", "null" ] }, "score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref8" }, "stage": { "type": [ "string", "null" ] }, "teams": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref9" }, "minItems": 2 }, "venue": { "type": [ "string", "null" ] }, "status": { "type": "string" }, "event_urn": { "type": "string" }, "fixture_id": { "type": [ "string", "integer" ] }, "start_date": { "type": "string" }, "competition": { "type": "string" }, "result_details": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref7" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref7": { "type": "object", "required": [ "schema_version", "fixture_id", "status", "regulation_time_score", "extra_time_score_contribution", "shootout_score", "winner", "provenance" ], "properties": { "status": { "enum": [ "FT", "AET", "PEN" ], "type": "string" }, "winner": { "type": [ "object", "null" ], "properties": { "name": { "type": "string" }, "team_id": { "type": "string" }, "qualifier": { "type": "string" } } }, "fixture_id": { "type": "string" }, "provenance": { "type": "object", "required": [ "provider", "fixture_id", "provider_result_sha256", "source_url", "observed_at" ], "properties": { "provider": { "type": "string" }, "fixture_id": { "type": "string" }, "source_url": { "type": "string", "format": "uri" }, "observed_at": { "type": [ "string", "null" ] }, "provider_result_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "schema_version": { "const": "worldcup-result-details-v1" }, "shootout_score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref8" }, "regulation_time_score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref8" }, "extra_time_score_contribution": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref8" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref8": { "type": [ "object", "null" ], "properties": { "away": { "type": "integer", "minimum": 0 }, "home": { "type": "integer", "minimum": 0 }, "elapsed": { "type": "number", "minimum": 0 } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref9": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string" }, "crest": { "type": [ "string", "null" ] }, "team_urn": { "type": [ "string", "null" ] }, "qualifier": { "type": "string" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref10": { "type": "object", "required": [ "meta", "status", "data", "error" ], "properties": { "data": { "type": "object", "description": "Always empty on an error." }, "meta": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref0" } ] }, "error": { "type": "object", "required": [ "code", "message" ], "properties": { "code": { "type": "integer", "description": "Mirrors the HTTP status code." }, "type": { "enum": [ "selector_required", "selector_ambiguous", "unsupported_parameter", "not_found", "capability_unavailable", "archive_error" ], "type": "string", "description": "Gateway classification of an unserved answer (absent on auth/credit errors)." }, "billed": { "const": false, "description": "Always false on an unserved answer: no credit debit, no ZeroClick usage." }, "archive": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref3" }, "message": { "type": "string" }, "coverage": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref4" }, "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref6" }, "description": "Fixtures that matched an ambiguous selector." }, "top_up_url": { "type": "string", "description": "On 402 only: where to buy credits." }, "reason_code": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref11" }, "accepted_fields": { "type": "array", "items": { "type": "string" }, "description": "Request fields the endpoint accepts; use them to correct the call." } } }, "status": { "const": "error" } }, "description": "Transport envelope of every non-2xx answer (machina-client-api core/worldcup/gateway.py). Unserved archived answers (selector missing or ambiguous, unknown fixture, unsupported parameter, capability gap) are typed here and are never billed." }, "sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref11": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string", "description": "Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed." }, "sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref0": { "type": "object", "required": [ "code" ], "properties": { "code": { "type": "integer", "description": "Mirrors the HTTP status code." } }, "description": "Platform-owned envelope metadata." }, "sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref1": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref2" }, { "type": "object", "required": [ "entity", "entities", "count" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "entity": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref5" }, "entities": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref5" } } } } ] }, "sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref2": { "type": "object", "required": [ "archive", "coverage", "warnings" ], "properties": { "archive": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref3" }, "coverage": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref4" }, "warnings": { "type": "array", "items": { "type": "string" } } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref3": { "type": "object", "required": [ "mode", "version", "status", "competition", "competition_status", "live", "snapshot_as_of", "capability_status", "provenance", "missing_capabilities", "notes" ], "properties": { "live": { "const": false }, "mode": { "const": "final_archive" }, "notes": { "type": "array", "items": { "type": "string" } }, "status": { "enum": [ "hit", "miss", "unavailable", "error" ], "type": "string", "description": "hit = an immutable archived row was served. unavailable/error = nothing was served; see coverage.reason_code. A `miss` never reaches the public surface." }, "version": { "enum": [ "world-cup-2026-final-v2", "world-cup-2026-final-v3" ], "type": "string" }, "provenance": { "type": "array", "items": { "type": "string" } }, "competition": { "const": "FIFA World Cup 2026" }, "reason_code": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string" }, "snapshot_as_of": { "type": [ "string", "null" ] }, "response_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "capability_status": { "type": "string" }, "competition_status": { "const": "completed" }, "content_created_at": { "type": [ "string", "null" ] }, "source_observed_at": { "type": [ "string", "null" ] }, "timestamp_semantics": { "type": "string" }, "missing_capabilities": { "type": "array", "items": { "type": "string" } }, "source_manifest_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "request_identity_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref4": { "type": "object", "required": [ "schema_version", "status", "reason", "scope", "mode", "source_provenance", "population_count", "eligible_count", "included_count", "excluded_count", "exclusion_reasons", "unsupported_fields" ], "properties": { "mode": { "const": "historical" }, "scope": { "const": "completed_tournament_archive" }, "reason": { "type": "string", "minLength": 1 }, "status": { "enum": [ "complete", "partial", "unavailable", "error" ], "type": "string" }, "reason_code": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string", "description": "Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed." }, "eligible_count": { "type": [ "integer", "null" ], "minimum": 0 }, "excluded_count": { "type": [ "integer", "null" ], "minimum": 0 }, "included_count": { "type": [ "integer", "null" ], "minimum": 0 }, "schema_version": { "const": "worldcup-storefront-coverage-v1" }, "accepted_fields": { "type": "array", "items": { "type": "string" }, "description": "The request fields this endpoint accepts, echoed on unserved responses so an agent can self-correct." }, "population_count": { "type": [ "integer", "null" ], "minimum": 0, "description": "Null means the legacy response did not record this count; null is never equivalent to zero." }, "exclusion_reasons": { "type": "object", "additionalProperties": { "type": "integer", "minimum": 0 } }, "source_provenance": { "type": "array", "items": { "type": "string" } }, "unsupported_fields": { "type": "array", "items": { "type": "string" } } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref5": { "type": "object", "properties": { "@id": { "type": [ "string", "null" ] }, "_id": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "player_key": { "type": "string" }, "provider_ids": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref7" }, "provider_id_aliases": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "string" } } }, "official_registration": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref6" }, "identity_mapping_status": { "enum": [ "canonical", "official_reconciled", "provider_only", "quarantined" ], "type": "string" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref6": { "type": "object", "required": [ "status", "source_url", "source_sha256", "published_at", "source_page", "team_name", "fifa_team_code", "jersey_number", "player_name_raw", "birth_date", "position_code", "warnings", "canonical_birth_date_conflict" ], "properties": { "source": { "const": "FIFA" }, "status": { "const": "verified_final_published_snapshot" }, "club_raw": { "type": [ "string", "null" ] }, "warnings": { "type": "array", "items": { "type": "string" } }, "height_cm": { "type": "integer" }, "team_name": { "type": "string" }, "birth_date": { "type": "string", "format": "date" }, "scope_note": { "type": "string" }, "source_url": { "type": "string", "format": "uri" }, "source_page": { "type": "integer", "maximum": 48, "minimum": 1 }, "published_at": { "type": "string", "format": "date-time" }, "jersey_number": { "type": "integer", "maximum": 26, "minimum": 1 }, "position_code": { "enum": [ "GK", "DF", "MF", "FW" ] }, "source_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "fifa_team_code": { "type": "string" }, "last_names_raw": { "type": "string" }, "shirt_name_raw": { "type": "string" }, "first_names_raw": { "type": "string" }, "player_name_raw": { "type": "string" }, "canonical_birth_date": { "type": [ "string", "null" ] }, "canonical_birth_date_conflict": { "type": "boolean" }, "international_caps_as_reported": { "type": "integer" }, "international_goals_as_reported": { "type": "integer" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref7": { "type": "object", "additionalProperties": { "type": [ "string", "integer", "null" ] } }, "sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref8": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref2" }, { "type": "object", "properties": { "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref9" } } } } ] }, "sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref9": { "type": "object", "required": [ "event_urn", "name", "start_date", "status", "teams", "fixture_id" ], "properties": { "name": { "type": "string" }, "round": { "type": [ "string", "null" ] }, "score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref11" }, "stage": { "type": [ "string", "null" ] }, "teams": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref12" }, "minItems": 2 }, "venue": { "type": [ "string", "null" ] }, "status": { "type": "string" }, "event_urn": { "type": "string" }, "fixture_id": { "type": [ "string", "integer" ] }, "start_date": { "type": "string" }, "competition": { "type": "string" }, "result_details": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref10" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref10": { "type": "object", "required": [ "schema_version", "fixture_id", "status", "regulation_time_score", "extra_time_score_contribution", "shootout_score", "winner", "provenance" ], "properties": { "status": { "enum": [ "FT", "AET", "PEN" ], "type": "string" }, "winner": { "type": [ "object", "null" ], "properties": { "name": { "type": "string" }, "team_id": { "type": "string" }, "qualifier": { "type": "string" } } }, "fixture_id": { "type": "string" }, "provenance": { "type": "object", "required": [ "provider", "fixture_id", "provider_result_sha256", "source_url", "observed_at" ], "properties": { "provider": { "type": "string" }, "fixture_id": { "type": "string" }, "source_url": { "type": "string", "format": "uri" }, "observed_at": { "type": [ "string", "null" ] }, "provider_result_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "schema_version": { "const": "worldcup-result-details-v1" }, "shootout_score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref11" }, "regulation_time_score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref11" }, "extra_time_score_contribution": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref11" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref11": { "type": [ "object", "null" ], "properties": { "away": { "type": "integer", "minimum": 0 }, "home": { "type": "integer", "minimum": 0 }, "elapsed": { "type": "number", "minimum": 0 } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref12": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string" }, "crest": { "type": [ "string", "null" ] }, "team_urn": { "type": [ "string", "null" ] }, "qualifier": { "type": "string" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref13": { "type": "object", "required": [ "meta", "status", "data", "error" ], "properties": { "data": { "type": "object", "description": "Always empty on an error." }, "meta": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref0" } ] }, "error": { "type": "object", "required": [ "code", "message" ], "properties": { "code": { "type": "integer", "description": "Mirrors the HTTP status code." }, "type": { "enum": [ "selector_required", "selector_ambiguous", "unsupported_parameter", "not_found", "capability_unavailable", "archive_error" ], "type": "string", "description": "Gateway classification of an unserved answer (absent on auth/credit errors)." }, "billed": { "const": false, "description": "Always false on an unserved answer: no credit debit, no ZeroClick usage." }, "archive": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref3" }, "message": { "type": "string" }, "coverage": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref4" }, "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref9" }, "description": "Fixtures that matched an ambiguous selector." }, "top_up_url": { "type": "string", "description": "On 402 only: where to buy credits." }, "reason_code": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref14" }, "accepted_fields": { "type": "array", "items": { "type": "string" }, "description": "Request fields the endpoint accepts; use them to correct the call." } } }, "status": { "const": "error" } }, "description": "Transport envelope of every non-2xx answer (machina-client-api core/worldcup/gateway.py). Unserved archived answers (selector missing or ambiguous, unknown fixture, unsupported parameter, capability gap) are typed here and are never billed." }, "sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref14": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string", "description": "Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed." }, "sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref0": { "type": "object", "anyOf": [ { "required": [ "event_urn" ] }, { "required": [ "provider_event_id" ] }, { "required": [ "event" ] }, { "required": [ "team" ] } ], "properties": { "date": { "type": "string", "format": "date", "description": "Fixture date, YYYY-MM-DD." }, "team": { "type": "string", "description": "One team name." }, "event": { "type": "string", "description": "Fixture label such as Brazil vs Morocco." }, "opponent": { "type": "string", "description": "Opponent name used to disambiguate." }, "event_urn": { "type": "string", "description": "Canonical event URN." }, "provider_event_id": { "type": "string", "description": "API-Football fixture id." } }, "description": "Supply an exact id or enough team/date information to resolve exactly one fixture. Multiple supplied selectors are conjunctive. Ambiguous requests return candidates and do not call a provider." }, "sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref1": { "type": "object", "required": [ "code" ], "properties": { "code": { "type": "integer", "description": "Mirrors the HTTP status code." } }, "description": "Platform-owned envelope metadata." }, "sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref2": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref3" }, { "type": "object", "required": [ "skill_card", "event_urn", "resolved_fixture", "candidates", "served_from" ], "properties": { "event_urn": { "type": "string" }, "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref6" } }, "skill_card": { "type": "object", "required": [ "headline", "final_score", "historical_perspective", "content_depth" ], "properties": { "headline": { "type": "string" }, "final_score": { "type": "string" }, "content_depth": { "type": "object", "required": [ "tier", "observed_player_records", "unsupported_narrative", "narrative_verification" ] }, "historical_perspective": { "type": "string" } } }, "served_from": { "const": "final_archive" }, "resolved_fixture": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref6" } } } ] }, "sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref3": { "type": "object", "required": [ "archive", "coverage", "warnings" ], "properties": { "archive": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref4" }, "coverage": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref5" }, "warnings": { "type": "array", "items": { "type": "string" } } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref4": { "type": "object", "required": [ "mode", "version", "status", "competition", "competition_status", "live", "snapshot_as_of", "capability_status", "provenance", "missing_capabilities", "notes" ], "properties": { "live": { "const": false }, "mode": { "const": "final_archive" }, "notes": { "type": "array", "items": { "type": "string" } }, "status": { "enum": [ "hit", "miss", "unavailable", "error" ], "type": "string", "description": "hit = an immutable archived row was served. unavailable/error = nothing was served; see coverage.reason_code. A `miss` never reaches the public surface." }, "version": { "enum": [ "world-cup-2026-final-v2", "world-cup-2026-final-v3" ], "type": "string" }, "provenance": { "type": "array", "items": { "type": "string" } }, "competition": { "const": "FIFA World Cup 2026" }, "reason_code": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string" }, "snapshot_as_of": { "type": [ "string", "null" ] }, "response_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "capability_status": { "type": "string" }, "competition_status": { "const": "completed" }, "content_created_at": { "type": [ "string", "null" ] }, "source_observed_at": { "type": [ "string", "null" ] }, "timestamp_semantics": { "type": "string" }, "missing_capabilities": { "type": "array", "items": { "type": "string" } }, "source_manifest_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "request_identity_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref5": { "type": "object", "required": [ "schema_version", "status", "reason", "scope", "mode", "source_provenance", "population_count", "eligible_count", "included_count", "excluded_count", "exclusion_reasons", "unsupported_fields" ], "properties": { "mode": { "const": "historical" }, "scope": { "const": "completed_tournament_archive" }, "reason": { "type": "string", "minLength": 1 }, "status": { "enum": [ "complete", "partial", "unavailable", "error" ], "type": "string" }, "reason_code": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string", "description": "Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed." }, "eligible_count": { "type": [ "integer", "null" ], "minimum": 0 }, "excluded_count": { "type": [ "integer", "null" ], "minimum": 0 }, "included_count": { "type": [ "integer", "null" ], "minimum": 0 }, "schema_version": { "const": "worldcup-storefront-coverage-v1" }, "accepted_fields": { "type": "array", "items": { "type": "string" }, "description": "The request fields this endpoint accepts, echoed on unserved responses so an agent can self-correct." }, "population_count": { "type": [ "integer", "null" ], "minimum": 0, "description": "Null means the legacy response did not record this count; null is never equivalent to zero." }, "exclusion_reasons": { "type": "object", "additionalProperties": { "type": "integer", "minimum": 0 } }, "source_provenance": { "type": "array", "items": { "type": "string" } }, "unsupported_fields": { "type": "array", "items": { "type": "string" } } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref6": { "type": "object", "required": [ "event_urn", "name", "start_date", "status", "teams", "fixture_id" ], "properties": { "name": { "type": "string" }, "round": { "type": [ "string", "null" ] }, "score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref8" }, "stage": { "type": [ "string", "null" ] }, "teams": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref9" }, "minItems": 2 }, "venue": { "type": [ "string", "null" ] }, "status": { "type": "string" }, "event_urn": { "type": "string" }, "fixture_id": { "type": [ "string", "integer" ] }, "start_date": { "type": "string" }, "competition": { "type": "string" }, "result_details": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref7" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref7": { "type": "object", "required": [ "schema_version", "fixture_id", "status", "regulation_time_score", "extra_time_score_contribution", "shootout_score", "winner", "provenance" ], "properties": { "status": { "enum": [ "FT", "AET", "PEN" ], "type": "string" }, "winner": { "type": [ "object", "null" ], "properties": { "name": { "type": "string" }, "team_id": { "type": "string" }, "qualifier": { "type": "string" } } }, "fixture_id": { "type": "string" }, "provenance": { "type": "object", "required": [ "provider", "fixture_id", "provider_result_sha256", "source_url", "observed_at" ], "properties": { "provider": { "type": "string" }, "fixture_id": { "type": "string" }, "source_url": { "type": "string", "format": "uri" }, "observed_at": { "type": [ "string", "null" ] }, "provider_result_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "schema_version": { "const": "worldcup-result-details-v1" }, "shootout_score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref8" }, "regulation_time_score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref8" }, "extra_time_score_contribution": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref8" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref8": { "type": [ "object", "null" ], "properties": { "away": { "type": "integer", "minimum": 0 }, "home": { "type": "integer", "minimum": 0 }, "elapsed": { "type": "number", "minimum": 0 } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref9": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string" }, "crest": { "type": [ "string", "null" ] }, "team_urn": { "type": [ "string", "null" ] }, "qualifier": { "type": "string" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref10": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref3" }, { "type": "object", "properties": { "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref6" } } } } ] }, "sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref11": { "type": "object", "required": [ "meta", "status", "data", "error" ], "properties": { "data": { "type": "object", "description": "Always empty on an error." }, "meta": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref1" } ] }, "error": { "type": "object", "required": [ "code", "message" ], "properties": { "code": { "type": "integer", "description": "Mirrors the HTTP status code." }, "type": { "enum": [ "selector_required", "selector_ambiguous", "unsupported_parameter", "not_found", "capability_unavailable", "archive_error" ], "type": "string", "description": "Gateway classification of an unserved answer (absent on auth/credit errors)." }, "billed": { "const": false, "description": "Always false on an unserved answer: no credit debit, no ZeroClick usage." }, "archive": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref4" }, "message": { "type": "string" }, "coverage": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref5" }, "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref6" }, "description": "Fixtures that matched an ambiguous selector." }, "top_up_url": { "type": "string", "description": "On 402 only: where to buy credits." }, "reason_code": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref12" }, "accepted_fields": { "type": "array", "items": { "type": "string" }, "description": "Request fields the endpoint accepts; use them to correct the call." } } }, "status": { "const": "error" } }, "description": "Transport envelope of every non-2xx answer (machina-client-api core/worldcup/gateway.py). Unserved archived answers (selector missing or ambiguous, unknown fixture, unsupported parameter, capability gap) are typed here and are never billed." }, "sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref12": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string", "description": "Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed." }, "sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref0": { "type": "object", "required": [ "code" ], "properties": { "code": { "type": "integer", "description": "Mirrors the HTTP status code." } }, "description": "Platform-owned envelope metadata." }, "sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref1": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref2" }, { "type": "object", "allOf": [ { "if": { "required": [ "content_type" ], "properties": { "content_type": { "const": "original_editorial_with_structured_retrospective" } } }, "then": { "required": [ "original_editorial" ], "properties": { "original_editorial": { "type": "object", "minProperties": 1 } } } } ], "required": [ "skill_card", "structured_retrospective", "content_type", "player_key", "player_urn", "resolved_player", "player_overview", "candidates", "served_from" ], "properties": { "candidates": { "type": "array", "maxItems": 1, "minItems": 1 }, "player_key": { "type": "string" }, "player_urn": { "type": [ "string", "null" ] }, "skill_card": { "type": "object" }, "served_from": { "const": "final_archive" }, "content_type": { "enum": [ "structured_retrospective", "original_editorial_with_structured_retrospective" ] }, "player_overview": { "type": "object", "required": [ "player_key", "name", "provider_ids", "identity_mapping_status" ] }, "resolved_player": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref5" }, "original_editorial": { "type": [ "object", "null" ] }, "structured_retrospective": { "type": "object", "required": [ "content_type", "historical_perspective", "player_key", "name", "identity_mapping_status", "provider_ids", "observed_appearance_count", "observed_opponents", "observations", "unsupported_fields", "grounding" ] } } } ] }, "sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref2": { "type": "object", "required": [ "archive", "coverage", "warnings" ], "properties": { "archive": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref3" }, "coverage": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref4" }, "warnings": { "type": "array", "items": { "type": "string" } } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref3": { "type": "object", "required": [ "mode", "version", "status", "competition", "competition_status", "live", "snapshot_as_of", "capability_status", "provenance", "missing_capabilities", "notes" ], "properties": { "live": { "const": false }, "mode": { "const": "final_archive" }, "notes": { "type": "array", "items": { "type": "string" } }, "status": { "enum": [ "hit", "miss", "unavailable", "error" ], "type": "string", "description": "hit = an immutable archived row was served. unavailable/error = nothing was served; see coverage.reason_code. A `miss` never reaches the public surface." }, "version": { "enum": [ "world-cup-2026-final-v2", "world-cup-2026-final-v3" ], "type": "string" }, "provenance": { "type": "array", "items": { "type": "string" } }, "competition": { "const": "FIFA World Cup 2026" }, "reason_code": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string" }, "snapshot_as_of": { "type": [ "string", "null" ] }, "response_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "capability_status": { "type": "string" }, "competition_status": { "const": "completed" }, "content_created_at": { "type": [ "string", "null" ] }, "source_observed_at": { "type": [ "string", "null" ] }, "timestamp_semantics": { "type": "string" }, "missing_capabilities": { "type": "array", "items": { "type": "string" } }, "source_manifest_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "request_identity_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref4": { "type": "object", "required": [ "schema_version", "status", "reason", "scope", "mode", "source_provenance", "population_count", "eligible_count", "included_count", "excluded_count", "exclusion_reasons", "unsupported_fields" ], "properties": { "mode": { "const": "historical" }, "scope": { "const": "completed_tournament_archive" }, "reason": { "type": "string", "minLength": 1 }, "status": { "enum": [ "complete", "partial", "unavailable", "error" ], "type": "string" }, "reason_code": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string", "description": "Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed." }, "eligible_count": { "type": [ "integer", "null" ], "minimum": 0 }, "excluded_count": { "type": [ "integer", "null" ], "minimum": 0 }, "included_count": { "type": [ "integer", "null" ], "minimum": 0 }, "schema_version": { "const": "worldcup-storefront-coverage-v1" }, "accepted_fields": { "type": "array", "items": { "type": "string" }, "description": "The request fields this endpoint accepts, echoed on unserved responses so an agent can self-correct." }, "population_count": { "type": [ "integer", "null" ], "minimum": 0, "description": "Null means the legacy response did not record this count; null is never equivalent to zero." }, "exclusion_reasons": { "type": "object", "additionalProperties": { "type": "integer", "minimum": 0 } }, "source_provenance": { "type": "array", "items": { "type": "string" } }, "unsupported_fields": { "type": "array", "items": { "type": "string" } } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref5": { "type": "object", "properties": { "@id": { "type": [ "string", "null" ] }, "_id": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "player_key": { "type": "string" }, "provider_ids": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref7" }, "provider_id_aliases": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "string" } } }, "official_registration": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref6" }, "identity_mapping_status": { "enum": [ "canonical", "official_reconciled", "provider_only", "quarantined" ], "type": "string" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref6": { "type": "object", "required": [ "status", "source_url", "source_sha256", "published_at", "source_page", "team_name", "fifa_team_code", "jersey_number", "player_name_raw", "birth_date", "position_code", "warnings", "canonical_birth_date_conflict" ], "properties": { "source": { "const": "FIFA" }, "status": { "const": "verified_final_published_snapshot" }, "club_raw": { "type": [ "string", "null" ] }, "warnings": { "type": "array", "items": { "type": "string" } }, "height_cm": { "type": "integer" }, "team_name": { "type": "string" }, "birth_date": { "type": "string", "format": "date" }, "scope_note": { "type": "string" }, "source_url": { "type": "string", "format": "uri" }, "source_page": { "type": "integer", "maximum": 48, "minimum": 1 }, "published_at": { "type": "string", "format": "date-time" }, "jersey_number": { "type": "integer", "maximum": 26, "minimum": 1 }, "position_code": { "enum": [ "GK", "DF", "MF", "FW" ] }, "source_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "fifa_team_code": { "type": "string" }, "last_names_raw": { "type": "string" }, "shirt_name_raw": { "type": "string" }, "first_names_raw": { "type": "string" }, "player_name_raw": { "type": "string" }, "canonical_birth_date": { "type": [ "string", "null" ] }, "canonical_birth_date_conflict": { "type": "boolean" }, "international_caps_as_reported": { "type": "integer" }, "international_goals_as_reported": { "type": "integer" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref7": { "type": "object", "additionalProperties": { "type": [ "string", "integer", "null" ] } }, "sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref8": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref2" }, { "type": "object", "properties": { "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref9" } } } } ] }, "sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref9": { "type": "object", "required": [ "event_urn", "name", "start_date", "status", "teams", "fixture_id" ], "properties": { "name": { "type": "string" }, "round": { "type": [ "string", "null" ] }, "score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref11" }, "stage": { "type": [ "string", "null" ] }, "teams": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref12" }, "minItems": 2 }, "venue": { "type": [ "string", "null" ] }, "status": { "type": "string" }, "event_urn": { "type": "string" }, "fixture_id": { "type": [ "string", "integer" ] }, "start_date": { "type": "string" }, "competition": { "type": "string" }, "result_details": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref10" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref10": { "type": "object", "required": [ "schema_version", "fixture_id", "status", "regulation_time_score", "extra_time_score_contribution", "shootout_score", "winner", "provenance" ], "properties": { "status": { "enum": [ "FT", "AET", "PEN" ], "type": "string" }, "winner": { "type": [ "object", "null" ], "properties": { "name": { "type": "string" }, "team_id": { "type": "string" }, "qualifier": { "type": "string" } } }, "fixture_id": { "type": "string" }, "provenance": { "type": "object", "required": [ "provider", "fixture_id", "provider_result_sha256", "source_url", "observed_at" ], "properties": { "provider": { "type": "string" }, "fixture_id": { "type": "string" }, "source_url": { "type": "string", "format": "uri" }, "observed_at": { "type": [ "string", "null" ] }, "provider_result_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" } } }, "schema_version": { "const": "worldcup-result-details-v1" }, "shootout_score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref11" }, "regulation_time_score": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref11" }, "extra_time_score_contribution": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref11" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref11": { "type": [ "object", "null" ], "properties": { "away": { "type": "integer", "minimum": 0 }, "home": { "type": "integer", "minimum": 0 }, "elapsed": { "type": "number", "minimum": 0 } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref12": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string" }, "crest": { "type": [ "string", "null" ] }, "team_urn": { "type": [ "string", "null" ] }, "qualifier": { "type": "string" } } }, "sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref13": { "type": "object", "required": [ "meta", "status", "data", "error" ], "properties": { "data": { "type": "object", "description": "Always empty on an error." }, "meta": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref0" } ] }, "error": { "type": "object", "required": [ "code", "message" ], "properties": { "code": { "type": "integer", "description": "Mirrors the HTTP status code." }, "type": { "enum": [ "selector_required", "selector_ambiguous", "unsupported_parameter", "not_found", "capability_unavailable", "archive_error" ], "type": "string", "description": "Gateway classification of an unserved answer (absent on auth/credit errors)." }, "billed": { "const": false, "description": "Always false on an unserved answer: no credit debit, no ZeroClick usage." }, "archive": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref3" }, "message": { "type": "string" }, "coverage": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref4" }, "candidates": { "type": "array", "items": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref9" }, "description": "Fixtures that matched an ambiguous selector." }, "top_up_url": { "type": "string", "description": "On 402 only: where to buy credits." }, "reason_code": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref14" }, "accepted_fields": { "type": "array", "items": { "type": "string" }, "description": "Request fields the endpoint accepts; use them to correct the call." } } }, "status": { "const": "error" } }, "description": "Transport envelope of every non-2xx answer (machina-client-api core/worldcup/gateway.py). Unserved archived answers (selector missing or ambiguous, unknown fixture, unsupported parameter, capability gap) are typed here and are never billed." }, "sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref14": { "enum": [ "fixture_selector_required", "fixture_ambiguous", "fixture_not_found", "player_selector_required", "player_ambiguous", "player_not_found", "entity_selector_required", "entity_ambiguous", "entity_not_found", "unsupported_parameter", "archive_row_missing", "archive_error" ], "type": "string", "description": "Machine-readable cause, present whenever status is unavailable or error. Request-side codes (fixture_*/player_*/entity_*/unsupported_parameter) mean the caller can fix the request; the gateway answers them with HTTP 400 (missing/ambiguous/unsupported) or 404 (not_found). archive_row_missing (HTTP 503) and archive_error (HTTP 502) are on our side. None of these calls is billed." } } }, "paths": { "/markets/v1/link-snapshot": { "post": { "summary": "Reference prices for the one game a venue link points at", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref1" } } }, "headers": { "zc-usage": { "schema": { "type": "string" }, "description": "Local usage instruction; not proof of provider settlement." }, "zc-replay": { "schema": { "const": "1" }, "description": "Present only on a replayed re-delivery (not charged)." } }, "description": "Billable (`status` ok or partial). Carries `zc-usage` on the first delivery; a replay carries `zc-replay: 1` and no `zc-usage`. Contract: Billable, `/1` or `/2` by resolved market." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref2" } } }, "description": "invalid_request or unsupported_url (not billed) Contract: invalid_request or unsupported_url (not billed, `/1`)" }, "401": { "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref15" }, { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref16" }, { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref17" } ] } } }, "description": "Not billed, nothing ran. Unsigned POST: `zeroclick_signature_required` pointing at discovery. Signed: the SDK's `invalid_zeroclick_signature` (bad, expired or tampered), or `zeroclick_identity_required` when the verified request carries no agent or request id.\n" }, "402": { "description": "Payment required" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref2" } } }, "description": "market_not_found (not billed) Contract: market_not_found (not billed, `/1`)" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref19" } } }, "description": "Nothing ran, not billed. `request_in_progress`: the same request is still claimed (running, or a billed answer that could not be stored, until 600 s). `request_id_reused`: this agent's request id was already billed for another request.\n" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref1" } } }, "description": "unsupported_market, ambiguous_market, game_not_matched, ambiguous_game or no_usable_prices (not billed) Contract: Not billed. `/2` only for `no_usable_prices` on a validated three-way result; every other 422 is `/1`." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref20" } } }, "headers": { "Retry-After": { "schema": { "type": "integer", "minimum": 1 } } }, "description": "The agent's per-minute budget is spent; nothing ran, not billed. A replay does not count." }, "503": { "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref2" }, { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref21" } ] } } }, "description": "Not billed. The document with `provider_unavailable` (venue/ESPN failure, deadline, saturation, invalid snapshot configuration), or a refusal before any work: the SDK's `allowance_unavailable`, missing seller/runtime config, an unexpected decision, or the replay store unavailable (fail closed). Contract: Not billed; `provider_unavailable` documents are `/1`." } }, "description": "Signed requests only. The ZeroClick seller SDK verifies the signature over the raw request and checks allowance before anything runs; an agent reaches this through the ZeroClick buyer path once the listing exists. Buyers never hold or use a seller signing secret.\nBilling: one `zc-usage` item (`market-link-snapshot` / `market_link_snapshot`, quantity 1) only on a 200 with `billable: true`. A 200 with `status: partial` is billable: at least one venue priced a side and the missing venues are listed in `coverage.missing`. Every other status is never billed.\nRe-delivery: within 600 s, the identical request (same verified `zc-agent-id` and `zc-request-id`, same method, path and query, byte-identical body) delivered again is answered with the retained response, `zc-replay: 1` and no `zc-usage`, only after signature verification and allowance approval. Exhausted allowance can return 402 even for a retained answer. Reuse of the same agent/request ID for other content conflicts with a retained record (409); another agent never receives that agent's remembered answer. Past 600 s, or after Redis data loss, an allowed re-signed delivery can execute and emit usage again. Provider settlement idempotency remains unverified. Unbilled attempts release the claim and do not retain a request fingerprint.\nFlags (server side): `SPORTS_SNAPSHOT_PUBLIC_ENABLED=1` registers the route; `ZEROCLICK_RATE_PER_MINUTE` (default 30) new requests per agent per minute; `SPORTS_SNAPSHOT_DEADLINE_S` (default 30) bounds the SDK call; `SPORTS_SNAPSHOT_MAX_INFLIGHT` (default 3) per serving process. An invalid value of any of the last three answers 503 (never billed, nothing runs).\n\nResponse contract selection: the server picks the contract from the market the link resolved to; the buyer does not choose it. A two-way full-game moneyline answers `sports-market-link-snapshot/1` (MarketLinkV1SnapshotResponse, unchanged). A UCL three-way regulation moneyline (home / away / draw after 90 minutes plus stoppage, no extra time or penalties) answers `sports-market-link-snapshot/2` (MarketLinkV2SnapshotResponse). `/1` is not widened: a `/1` document never carries a draw, market markers or quote identity. Every error before a validated three-way result (bad link, game not matched, provider failure, a malformed or inconsistent three-way SDK result) is a `/1` error document. A validated three-way result with no usable price is a `/2` `no_usable_prices` document. Same route, price, meter, auth, replay and rate limit for both contracts; billable: a 200 with `billable: true`, on either contract. Responses are the bare snapshot document, not the World Cup transport envelope.", "operationId": "getMarketLinkSnapshot", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_c0d214fb5bbb45bc_ref0", "description": "`https://polymarket.com/event/[/]`, `https://polymarket.com/sports/ucl/` or `https://kalshi.com/markets///`, single games only." }, "examples": { "kalshi_ucl": { "value": { "url": "https://kalshi.com/markets/kxuclgame/uefa-champions-league-game/kxuclgame-26oct20psgbar" } }, "polymarket": { "value": { "url": "https://polymarket.com/event/nba-nyk-bos-2026-10-21" } }, "polymarket_ucl": { "value": { "url": "https://polymarket.com/sports/ucl/ucl-psg-fcb-2026-10-20" } } } } }, "required": true, "description": "Request URL: `https://polymarket.com/event/[/]`, `https://polymarket.com/sports/ucl/` or `https://kalshi.com/markets///`, single games only." }, "x-zeroclick-document-sources": [ { "gaps": [], "pages": [], "sourceId": "sds_kS_Na0vlgH8jHcvZiy8eD", "authority": "official", "conflicts": [], "revisionId": "sdrn_IB5cI6fYy5LIS4OREpc2m" } ], "x-zeroclick-services": [ "market-link-snapshot" ], "x-payment-info": { "access": "payg", "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "50000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.050000 per snapshot (market_link_snapshot, service market-link-snapshot)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "rates": [ { "service": "market-link-snapshot", "meter": "market_link_snapshot", "unit": "snapshot", "unitSize": 1, "priceUsd": "0.050000", "includedUnits": 0 } ] } } }, "/world-cup/v1/backtest-forecasts": { "post": { "summary": "Historical forecast backtests", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "data", "meta" ], "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref1" }, { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref5" } ] }, "meta": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref0" } ], "properties": { "code": { "const": 200 } } }, "status": { "const": "success" } }, "description": "Transport envelope as delivered by api.machina.gg and the ZeroClick storefront; `data` carries the endpoint payload." }, "examples": { "archived": { "value": { "data": { "status": "available", "archive": { "live": false, "mode": "final_archive", "notes": [ "Recomputed offline from original forecast bytes and verified regulation-time result evidence; six at/after-kickoff forecasts are excluded." ], "cutoff": null, "status": "hit", "version": "world-cup-2026-final-v3", "provenance": [ "worldcup:event", "worldcup:model-forecast", "api-football" ], "competition": "FIFA World Cup 2026", "sample_size": 98, "snapshot_as_of": null, "response_sha256": "bedbf248b374fb8722c05d49727596f28b6460b5fc656b52dc007b70842edc62", "capability_status": "historical_aggregate", "competition_status": "completed", "content_created_at": null, "source_observed_at": null, "timestamp_semantics": "unavailable", "missing_capabilities": [ "closing_line_value", "market_calibration" ], "source_manifest_sha256": "ab3a356583f2ea8a843f2e08136a01570f68b92a2c2d9864069b99b459bf897a", "request_identity_sha256": "c72bea8be682ebc91c8e7b83eb1e903267bfdd8261b1918a2fa5179fd87f13f0" }, "sources": [ "worldcup:event", "worldcup:model-forecast", "api-football" ], "coverage": { "mode": "historical", "scope": "completed_tournament_archive", "reason": "All forecasts with a pre-kickoff timestamp and verified regulation result were scored.", "status": "complete", "eligible_count": 98, "excluded_count": 6, "included_count": 98, "schema_version": "worldcup-storefront-coverage-v1", "population_count": 104, "exclusion_reasons": { "forecast_at_or_after_kickoff": 6 }, "source_provenance": [ "worldcup:event", "worldcup:model-forecast", "api-football" ], "unsupported_fields": [ "closing_line_value", "market_calibration" ] }, "warnings": [ "Using cached World Cup 2026 final events; provider freshness and completeness are not inferred." ], "clv_report": {}, "provenance": "verified-v2-result-details", "total_count": 104, "track_record": { "accuracy": { "total": 98, "correct": 52, "accuracy_percent": 53.06 }, "disclaimer": "Informational sports market intelligence only. Not betting, trading, financial, or investment advice.", "calibration": { "curve": [ { "bin": 3, "count": 11, "label": "30-40%", "actual_rate": 0.2727, "predicted_avg": 0.3798 }, { "bin": 4, "count": 35, "label": "40-50%", "actual_rate": 0.4571, "predicted_avg": 0.4446 }, { "bin": 5, "count": 24, "label": "50-60%", "actual_rate": 0.5417, "predicted_avg": 0.5481 } ], "avg_calibration_error": 0.0676 }, "sample_size": 98, "brier_scores": { "avg_1x2": 0.1913, "avg_over_2_5": 0.3057, "baseline_random": 0.2222, "baseline_random_1x2": 0.2222, "is_better_than_random": true, "baseline_random_over_2_5": 0.25 }, "recommendation": "1X2 mean Brier 0.1913 vs 0.2222 uniform baseline (better than uniform); calibration error 0.0676 (target <0.05).", "sample_size_sufficient": true }, "audited_count": 98, "excluded_count": 6, "included_count": 98, "clv_settled_count": 0, "exclusion_reasons": { "forecast_at_or_after_kickoff": 6 }, "finished_fixtures": [ { "goals": { "away": 0, "home": 2 }, "fixture": { "id": "1489369", "status": { "short": "FT" } } }, { "goals": { "away": 1, "home": 2 }, "fixture": { "id": "1538999", "status": { "short": "FT" } } }, { "goals": { "away": 1, "home": 1 }, "fixture": { "id": "1539000", "status": { "short": "FT" } } } ], "calibration_report": {}, "calibration_settled_count": 0 }, "meta": { "code": 200 }, "status": "success" }, "summary": "Real 200 body captured from the production archive on 2026-09-18 (arrays trimmed to 3 items) — wrapped in the transport envelope {status, meta, data}" } } } }, "description": "Archive backtest with total, included, excluded, sources, reasons, and track record." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref10" }, "examples": { "unsupported_parameter": { "value": { "data": {}, "meta": { "code": 400 }, "error": { "code": 400, "type": "unsupported_parameter", "billed": false, "archive": { "live": false, "mode": "final_archive", "notes": [ "Competition is outside the World Cup 2026 v3 archive catalog; no fallback execution is allowed." ], "status": "unavailable", "version": "world-cup-2026-final-v3", "provenance": [], "competition": "FIFA World Cup 2026", "reason_code": "unsupported_parameter", "snapshot_as_of": null, "capability_status": "unavailable", "competition_status": "completed", "missing_capabilities": [] }, "message": "Competition is outside the World Cup 2026 v3 archive catalog; no fallback execution is allowed.", "coverage": { "mode": "historical", "scope": "completed_tournament_archive", "reason": "Competition is outside the World Cup 2026 v3 archive catalog; no fallback execution is allowed.", "status": "unavailable", "reason_code": "unsupported_parameter", "eligible_count": null, "excluded_count": null, "included_count": null, "schema_version": "worldcup-storefront-coverage-v1", "accepted_fields": [ "competition", "league", "season", "calibration_window_days" ], "population_count": null, "exclusion_reasons": {}, "source_provenance": [], "unsupported_fields": [] }, "reason_code": "unsupported_parameter", "accepted_fields": [ "competition", "league", "season", "calibration_window_days" ] }, "status": "error" }, "summary": "Real body captured through the ZeroClick storefront (agents.machina.gg) on 2026-09-22: body {\"competition\":\"world-cup-2022\"}" } } } }, "description": "The request did not identify what to answer about (coverage.reason_code = fixture_selector_required / fixture_ambiguous / player_selector_required / player_ambiguous / entity_selector_required / entity_ambiguous) or used a parameter variant outside the archive catalog (unsupported_parameter). `candidates` lists the fixtures/players that matched when the selector was ambiguous. Never billed." }, "402": { "description": "Payment required" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref10" } } }, "description": "The selector resolved to no archived fixture / player / entity (coverage.reason_code = *_not_found). Never billed." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref10" } } }, "description": "Archive integrity error (coverage.reason_code = archive_error); nothing was served. Never billed." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_becc8bd2259856ad_ref10" } } }, "description": "A valid selector for which the archive holds no row (coverage.reason_code = archive_row_missing). Retry later. Never billed." } }, "description": "Scores the 98 original archived forecasts computed before kickoff against verified 90-minute results, including AET/PEN fixtures through regulation_time_score. Six late forecasts are excluded. CLV and market calibration remain explicitly unsupported. This completed World Cup path is read-only.", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "league": { "enum": [ "", "1" ], "type": "string", "default": "" }, "season": { "enum": [ "", "2026" ], "type": "string", "default": "" }, "competition": { "enum": [ "world-cup-2026" ], "type": "string", "default": "world-cup-2026" }, "calibration_window_days": { "type": "integer", "const": 90, "default": 90 } } }, "examples": { "captured": { "value": {}, "summary": "Request used for the captured 200 example" }, "completedTournament": { "value": { "competition": "world-cup-2026" } } } } }, "required": false }, "x-zeroclick-document-sources": [ { "gaps": [], "pages": [], "sourceId": "sds_kS_Na0vlgH8jHcvZiy8eD", "authority": "official", "conflicts": [], "revisionId": "sdrn_IB5cI6fYy5LIS4OREpc2m" }, { "gaps": [ "Missing request body schema", "Missing parameter definitions" ], "pages": [ 1 ], "sourceId": "sds_lEILwU1VMqWXAvmNynqZQ", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description", "/description" ], "revisionId": "sdrn_-CuYe8y_ET60tB1VhI3Sl" }, { "gaps": [ "Missing request body schema", "Missing parameters" ], "pages": [ 1 ], "sourceId": "sds_pYBubIfmVitksSAV5O4y8", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description" ], "revisionId": "sdrn_18lH1kSa6dItqVVxgexAA" } ], "x-zeroclick-services": [ "forecasts" ], "x-payment-info": { "access": "payg", "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "120000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.120000 per call (backtest, service forecasts)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.120000" }, "rates": [ { "service": "forecasts", "meter": "backtest", "unit": "call", "unitSize": 1, "priceUsd": "0.120000", "includedUnits": 0 } ], "perCallUsage": [ { "service": "forecasts", "meter": "backtest", "quantity": 1 } ] } } }, "/world-cup/v1/get-event-context": { "post": { "summary": "Enriched context for one match", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "data", "meta" ], "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref2" }, { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref13" } ] }, "meta": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref1" } ], "properties": { "code": { "const": 200 } } }, "status": { "const": "success" } }, "description": "Transport envelope as delivered by api.machina.gg and the ZeroClick storefront; `data` carries the endpoint payload." }, "examples": { "archived": { "value": { "data": { "archive": { "live": false, "mode": "final_archive", "notes": [ "Archived event truth is complete independently of optional enrichment." ], "status": "hit", "version": "world-cup-2026-final-v3", "provenance": [ "worldcup:event", "api-football" ], "competition": "FIFA World Cup 2026", "snapshot_as_of": "2026-09-13T17:08:22.003454Z", "response_sha256": "40017b0473975e10c9cbe60820b6e679febfdf273597d21787491640835d7736", "capability_status": "partial", "competition_status": "completed", "content_created_at": "2026-06-05 03:16:00+00:00", "source_observed_at": "2026-09-13T17:08:22.003454Z", "timestamp_semantics": "source_capture_observation", "missing_capabilities": [ "prematch_research", "social_pulse" ], "source_manifest_sha256": "f195a64430bb7961b528d19f29015055765b49d38b2600929b82f0cb92445a5b", "request_identity_sha256": "0de0e334b0061f5e50791a2e91d079da6b88b9f5c2bbe5530f20a31083486326" }, "coverage": { "mode": "historical", "scope": "completed_tournament_archive", "reason": "Retrospective sports context is derived from archived result and final standings evidence; it is not prematch research.", "status": "partial", "eligible_count": 1, "excluded_count": 0, "included_count": 1, "schema_version": "worldcup-storefront-coverage-v1", "population_count": 1, "exclusion_reasons": {}, "source_provenance": [ "worldcup:event", "api-football" ], "unsupported_fields": [ "prematch_research", "social_pulse" ] }, "warnings": [], "event_urn": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "candidates": [ { "name": "Brazil vs Morocco - FIFA World Cup 2026", "round": "Group Stage - 1", "score": { "away": 1, "home": 1, "elapsed": 90 }, "stage": "Group Stage - 1", "teams": [ { "name": "Brazil", "crest": "https://media.api-sports.io/football/teams/6.png", "team_urn": "urn:machina:sport:soccer:team:brazil:bra", "qualifier": "home" }, { "name": "Morocco", "crest": "https://media.api-sports.io/football/teams/31.png", "team_urn": "urn:machina:sport:soccer:team:morocco:mar", "qualifier": "away" } ], "venue": "MetLife Stadium", "status": "ft", "event_urn": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "fixture_id": "1489371", "start_date": "2026-06-13T22:00:00+00:00", "competition": "FIFA World Cup 2026" } ], "event_context": { "event": { "id": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "@id": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "_id": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "name": "Brazil vs Morocco - FIFA World Cup 2026", "@type": [ "sport:Event", "schema:SportsEvent" ], "round": "Group Stage - 1", "stage": "Group Stage - 1", "@context": { "sport": "https://www.sportschema.org/ontologies/sport#", "schema": "https://schema.org/", "machina": "https://schema.machina.gg/sports#" }, "live_score": { "away": 1, "home": 1, "elapsed": 90 }, "sport:venue": { "@id": "urn:machina:sport:soccer:venue:metlife-stadium:eas", "name": "MetLife Stadium", "@type": "sport:Venue", "schema:addressLocality": "East Rutherford" }, "provider_ids": { "opta": "ar8b186wqraa80u0vpi2e4nis", "entain": "7722038", "sportradar": "sr:sport_event:66456928", "api_football": "1489371" }, "sport:status": "FT", "schema:startDate": "2026-06-13T22:00:00+00:00", "sport:competition": { "@id": "urn:machina:sport:soccer:competition:fifa-world-cup-2026:wor", "name": "FIFA World Cup 2026", "@type": "sport:Competition" }, "sport:competitors": [ { "@id": "urn:machina:sport:soccer:team:brazil:bra", "name": "Brazil", "@type": "sport:Team", "schema:logo": "https://media.api-sports.io/football/teams/6.png", "sport:qualifier": "home" }, { "@id": "urn:machina:sport:soccer:team:morocco:mar", "name": "Morocco", "@type": "sport:Team", "schema:logo": "https://media.api-sports.io/football/teams/31.png", "sport:qualifier": "away" } ], "machina_competition_slug": "world-cup-2026" }, "social_pulse": {}, "result_details": { "status": "FT", "winner": null, "fixture_id": "1489371", "provenance": { "provider": "api-football", "capture_id": "6aa6d8852677921cf5d5f48e", "fixture_id": "1489371", "source_url": "https://www.api-football.com/", "observed_at": "2026-09-13T17:08:22.003454Z", "capture_name": "worldcup-archive-capture-results", "capture_sha256": "10522211a9442626d08c603aa9a01c4c3afe3ae2dfc7217e0e7e2290c5e85406", "provider_result_sha256": "9fb8564dae34abe16550eee706bd060efd31c24899c005231b4ae5f7ac7d9a55" }, "schema_version": "worldcup-result-details-v1", "shootout_score": null, "regulation_time_score": { "away": 1, "home": 1 }, "extra_time_score_contribution": null }, "sports_context": { "mode": "retrospective_completed_tournament", "status": "available", "result_details": { "status": "FT", "winner": null, "fixture_id": "1489371", "provenance": { "provider": "api-football", "capture_id": "6aa6d8852677921cf5d5f48e", "fixture_id": "1489371", "source_url": "https://www.api-football.com/", "observed_at": "2026-09-13T17:08:22.003454Z", "capture_name": "worldcup-archive-capture-results", "capture_sha256": "10522211a9442626d08c603aa9a01c4c3afe3ae2dfc7217e0e7e2290c5e85406", "provider_result_sha256": "9fb8564dae34abe16550eee706bd060efd31c24899c005231b4ae5f7ac7d9a55" }, "schema_version": "worldcup-result-details-v1", "shootout_score": null, "regulation_time_score": { "away": 1, "home": 1 }, "extra_time_score_contribution": null }, "final_group_standings": [] }, "context_coverage": { "reason": "Retrospective sports context is derived from archived result and final standings evidence; it is not prematch research.", "social_pulse": "unavailable", "sports_context": "available", "prematch_research": "unavailable" }, "prematch_research": {} }, "resolved_fixture": { "name": "Brazil vs Morocco - FIFA World Cup 2026", "round": "Group Stage - 1", "score": { "away": 1, "home": 1, "elapsed": 90 }, "stage": "Group Stage - 1", "teams": [ { "name": "Brazil", "crest": "https://media.api-sports.io/football/teams/6.png", "team_urn": "urn:machina:sport:soccer:team:brazil:bra", "qualifier": "home" }, { "name": "Morocco", "crest": "https://media.api-sports.io/football/teams/31.png", "team_urn": "urn:machina:sport:soccer:team:morocco:mar", "qualifier": "away" } ], "venue": "MetLife Stadium", "status": "ft", "event_urn": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "fixture_id": "1489371", "start_date": "2026-06-13T22:00:00+00:00", "competition": "FIFA World Cup 2026" } }, "meta": { "code": 200 }, "status": "success" }, "summary": "Real 200 body captured from the production archive on 2026-09-18 (arrays trimmed to 3 items) — wrapped in the transport envelope {status, meta, data}" } } } }, "description": "Resolved archived event context, or warnings and candidates." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref14" } } }, "description": "The request did not identify what to answer about (coverage.reason_code = fixture_selector_required / fixture_ambiguous / player_selector_required / player_ambiguous / entity_selector_required / entity_ambiguous) or used a parameter variant outside the archive catalog (unsupported_parameter). `candidates` lists the fixtures/players that matched when the selector was ambiguous. Never billed." }, "402": { "description": "Payment required" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref14" } } }, "description": "The selector resolved to no archived fixture / player / entity (coverage.reason_code = *_not_found). Never billed." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref14" } } }, "description": "Archive integrity error (coverage.reason_code = archive_error); nothing was served. Never billed." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref14" } } }, "description": "A valid selector for which the archive holds no row (coverage.reason_code = archive_row_missing). Retry later. Never billed." } }, "description": "Archived event truth plus optional enrichment. Ambiguous selectors return candidates instead of an arbitrary fixture.", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_137802b6987e7dd2_ref0" }, "examples": { "captured": { "value": { "event": "Brazil vs Morocco" }, "summary": "Request used for the captured 200 example" }, "canonical": { "value": { "event_urn": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor" } }, "plainEnglish": { "value": { "date": "2026-06-13", "team": "Brazil", "opponent": "Morocco" } } } } }, "required": true }, "x-zeroclick-document-sources": [ { "gaps": [], "pages": [], "sourceId": "sds_kS_Na0vlgH8jHcvZiy8eD", "authority": "official", "conflicts": [], "revisionId": "sdrn_IB5cI6fYy5LIS4OREpc2m" }, { "gaps": [ "Missing request body schema", "Missing parameter definitions" ], "pages": [ 1 ], "sourceId": "sds_lEILwU1VMqWXAvmNynqZQ", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description", "/description" ], "revisionId": "sdrn_-CuYe8y_ET60tB1VhI3Sl" }, { "gaps": [ "Missing request body schema", "Missing parameters" ], "pages": [ 1 ], "sourceId": "sds_pYBubIfmVitksSAV5O4y8", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description" ], "revisionId": "sdrn_18lH1kSa6dItqVVxgexAA" } ], "x-zeroclick-services": [ "match-context" ], "x-payment-info": { "access": "payg", "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "10000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.010000 per call (event_context, service match-context)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "rates": [ { "service": "match-context", "meter": "event_context", "unit": "call", "unitSize": 1, "priceUsd": "0.010000", "includedUnits": 0 } ], "perCallUsage": [ { "service": "match-context", "meter": "event_context", "quantity": 1 } ] } } }, "/world-cup/v1/get-injuries": { "post": { "summary": "Archived fixture injury reports", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "data", "meta" ], "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref2" }, { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref10" } ] }, "meta": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref1" } ], "properties": { "code": { "const": 200 } } }, "status": { "const": "success" } }, "description": "Transport envelope as delivered by api.machina.gg and the ZeroClick storefront; `data` carries the endpoint payload." }, "examples": { "archived": { "value": { "data": { "archive": { "live": false, "mode": "final_archive", "notes": [ "Absence feeds do not prove a complete historical injury record unless coverage_complete is explicitly true." ], "status": "hit", "version": "world-cup-2026-final-v3", "provenance": [ "api-football" ], "competition": "FIFA World Cup 2026", "snapshot_as_of": "2026-09-13T16:13:52Z", "response_sha256": "a5cc75f58da6856b32e032c74adc8f672ce6198cd6d53a96020aac50fc50b5af", "capability_status": "partial", "competition_status": "completed", "content_created_at": null, "source_observed_at": "2026-09-13T16:13:52Z", "timestamp_semantics": "source_capture_observation", "missing_capabilities": [ "verified_complete_injury_coverage" ], "source_manifest_sha256": "9ef8ab561fc756abe1320bbfaf87123e50172d654673357031aa77cfc82e4a56", "request_identity_sha256": "794325c477123f1975699ce307785513d599fa221af20dd33b1681aec18ba14d" }, "coverage": { "mode": "historical", "scope": "completed_tournament_archive", "reason": "Archived provider absence records exist for this fixture.", "status": "partial", "eligible_count": 1, "excluded_count": 0, "included_count": 1, "schema_version": "worldcup-storefront-coverage-v1", "population_count": 1, "exclusion_reasons": {}, "source_provenance": [ "api-football" ], "unsupported_fields": [ "complete_historical_injury_coverage" ] }, "injuries": { "teams": [ { "side": "home", "team": "Brazil", "count": 1, "source": "api-football", "missing": [ { "name": "Neymar", "type": "Missing Fixture", "photo": "https://media.api-sports.io/football/players/276.png", "reason": "Calf Injury", "player_id": 276, "fixture_id": 1489371, "fixture_date": "2026-06-13T22:00:00+00:00" } ], "team_id": null }, { "side": "away", "team": "Morocco", "count": 0, "source": "api-football", "missing": [], "team_id": null } ], "source": "api-football", "warnings": [], "evidence_status": "recorded_absences", "observed_record_count": 1, "historical_completeness_verified": false }, "warnings": [], "candidates": [ { "name": "Brazil vs Morocco - FIFA World Cup 2026", "round": "Group Stage - 1", "score": { "away": 1, "home": 1, "elapsed": 90 }, "stage": "Group Stage - 1", "teams": [ { "name": "Brazil", "crest": "https://media.api-sports.io/football/teams/6.png", "team_urn": "urn:machina:sport:soccer:team:brazil:bra", "qualifier": "home" }, { "name": "Morocco", "crest": "https://media.api-sports.io/football/teams/31.png", "team_urn": "urn:machina:sport:soccer:team:morocco:mar", "qualifier": "away" } ], "venue": "MetLife Stadium", "status": "ft", "event_urn": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "fixture_id": "1489371", "start_date": "2026-06-13T22:00:00+00:00", "competition": "FIFA World Cup 2026" } ] }, "meta": { "code": 200 }, "status": "success" }, "summary": "Real 200 body captured from the production archive on 2026-09-18 (arrays trimmed to 3 items) — wrapped in the transport envelope {status, meta, data}" }, "unavailable-before-1.4.0": { "value": { "data": { "archive": { "live": false, "mode": "final_archive", "notes": [ "A fixture selector is required: pass event_urn, provider_event_id, event (e.g. \"Brazil vs Morocco\"), or team with opponent/date." ], "status": "unavailable", "version": "world-cup-2026-final-v3", "provenance": [], "competition": "FIFA World Cup 2026", "reason_code": "fixture_selector_required", "snapshot_as_of": null, "capability_status": "unavailable", "competition_status": "completed", "missing_capabilities": [] }, "coverage": { "mode": "historical", "scope": "completed_tournament_archive", "reason": "A fixture selector is required: pass event_urn, provider_event_id, event (e.g. \"Brazil vs Morocco\"), or team with opponent/date.", "status": "unavailable", "reason_code": "fixture_selector_required", "eligible_count": null, "excluded_count": null, "included_count": null, "schema_version": "worldcup-storefront-coverage-v1", "accepted_fields": [ "event_urn", "provider_event_id", "event", "team", "opponent", "date", "league", "season" ], "population_count": null, "exclusion_reasons": {}, "source_provenance": [], "unsupported_fields": [] }, "injuries": {}, "warnings": [ "A fixture selector is required: pass event_urn, provider_event_id, event (e.g. \"Brazil vs Morocco\"), or team with opponent/date." ], "candidates": [] }, "meta": { "code": 200 }, "status": "success" }, "summary": "How an empty body was answered before 1.4.0 (HTTP 200, billed) — now HTTP 400, unbilled, with this coverage block — wrapped in the transport envelope {status, meta, data}" } } } }, "description": "Fixture-scoped injury evidence with coverage caveats." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref11" }, "examples": { "selector_required": { "value": { "data": {}, "meta": { "code": 400 }, "error": { "code": 400, "type": "selector_required", "billed": false, "archive": { "live": false, "mode": "final_archive", "notes": [ "A fixture selector is required: pass event_urn, provider_event_id, event (e.g. \"Brazil vs Morocco\"), or team with opponent/date." ], "status": "unavailable", "version": "world-cup-2026-final-v3", "provenance": [], "competition": "FIFA World Cup 2026", "reason_code": "fixture_selector_required", "snapshot_as_of": null, "capability_status": "unavailable", "competition_status": "completed", "missing_capabilities": [] }, "message": "A fixture selector is required: pass event_urn, provider_event_id, event (e.g. \"Brazil vs Morocco\"), or team with opponent/date.", "coverage": { "mode": "historical", "scope": "completed_tournament_archive", "reason": "A fixture selector is required: pass event_urn, provider_event_id, event (e.g. \"Brazil vs Morocco\"), or team with opponent/date.", "status": "unavailable", "reason_code": "fixture_selector_required", "eligible_count": null, "excluded_count": null, "included_count": null, "schema_version": "worldcup-storefront-coverage-v1", "accepted_fields": [ "event_urn", "provider_event_id", "event", "team", "opponent", "date", "league", "season" ], "population_count": null, "exclusion_reasons": {}, "source_provenance": [], "unsupported_fields": [] }, "reason_code": "fixture_selector_required", "accepted_fields": [ "event_urn", "provider_event_id", "event", "team", "opponent", "date", "league", "season" ] }, "status": "error" }, "summary": "Real body captured through the ZeroClick storefront (agents.machina.gg) on 2026-09-22: empty body" }, "selector_ambiguous": { "value": { "data": {}, "meta": { "code": 400 }, "error": { "code": 400, "type": "selector_ambiguous", "billed": false, "archive": { "live": false, "mode": "final_archive", "notes": [ "Fixture input is ambiguous; add opponent/date or use one candidate event_urn." ], "status": "unavailable", "version": "world-cup-2026-final-v3", "provenance": [], "competition": "FIFA World Cup 2026", "reason_code": "fixture_ambiguous", "snapshot_as_of": null, "capability_status": "unavailable", "competition_status": "completed", "missing_capabilities": [] }, "message": "Fixture input is ambiguous; add opponent/date or use one candidate event_urn.", "coverage": { "mode": "historical", "scope": "completed_tournament_archive", "reason": "Fixture input is ambiguous; add opponent/date or use one candidate event_urn.", "status": "unavailable", "reason_code": "fixture_ambiguous", "eligible_count": null, "excluded_count": null, "included_count": null, "schema_version": "worldcup-storefront-coverage-v1", "accepted_fields": [ "event_urn", "provider_event_id", "event", "team", "opponent", "date", "league", "season" ], "population_count": null, "exclusion_reasons": {}, "source_provenance": [], "unsupported_fields": [] }, "candidates": [ { "name": "Brazil vs Morocco - FIFA World Cup 2026", "round": "Group Stage - 1", "score": { "away": 1, "home": 1, "elapsed": 90 }, "stage": "Group Stage - 1", "teams": [ { "name": "Brazil", "crest": "https://media.api-sports.io/football/teams/6.png", "team_urn": "urn:machina:sport:soccer:team:brazil:bra", "qualifier": "home" }, { "name": "Morocco", "crest": "https://media.api-sports.io/football/teams/31.png", "team_urn": "urn:machina:sport:soccer:team:morocco:mar", "qualifier": "away" } ], "venue": "MetLife Stadium", "status": "ft", "event_urn": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "fixture_id": "1489371", "start_date": "2026-06-13T22:00:00+00:00", "competition": "FIFA World Cup 2026" }, { "name": "Brazil vs Haiti - FIFA World Cup 2026", "round": "Group Stage - 2", "score": { "away": 0, "home": 3, "elapsed": 90 }, "stage": "Group Stage - 2", "teams": [ { "name": "Brazil", "crest": "https://media.api-sports.io/football/teams/6.png", "team_urn": "urn:machina:sport:soccer:team:brazil:bra", "qualifier": "home" }, { "name": "Haiti", "crest": "https://media.api-sports.io/football/teams/2386.png", "team_urn": "urn:machina:sport:soccer:team:haiti:hti", "qualifier": "away" } ], "venue": "Lincoln Financial Field", "status": "ft", "event_urn": "urn:machina:sport:soccer:event:brazil-vs-haiti:20260620:wor", "fixture_id": "1489389", "start_date": "2026-06-20T00:30:00+00:00", "competition": "FIFA World Cup 2026" }, { "name": "Scotland vs Brazil - FIFA World Cup 2026", "round": "Group Stage - 3", "score": { "away": 3, "home": 0, "elapsed": 90 }, "stage": "Group Stage - 3", "teams": [ { "name": "Scotland", "crest": "https://media.api-sports.io/football/teams/1108.png", "team_urn": "urn:machina:sport:soccer:team:scotland:sco", "qualifier": "home" }, { "name": "Brazil", "crest": "https://media.api-sports.io/football/teams/6.png", "team_urn": "urn:machina:sport:soccer:team:brazil:bra", "qualifier": "away" } ], "venue": "Hard Rock Stadium", "status": "ft", "event_urn": "urn:machina:sport:soccer:event:scotland-vs-brazil:20260624:wor", "fixture_id": "1489406", "start_date": "2026-06-24T22:00:00+00:00", "competition": "FIFA World Cup 2026" } ], "reason_code": "fixture_ambiguous", "accepted_fields": [ "event_urn", "provider_event_id", "event", "team", "opponent", "date", "league", "season" ] }, "status": "error" }, "summary": "Real body captured through the ZeroClick storefront (agents.machina.gg) on 2026-09-22: body {\"team\":\"Brazil\"}; candidates trimmed to 3" } } } }, "description": "The request did not identify what to answer about (coverage.reason_code = fixture_selector_required / fixture_ambiguous / player_selector_required / player_ambiguous / entity_selector_required / entity_ambiguous) or used a parameter variant outside the archive catalog (unsupported_parameter). `candidates` lists the fixtures/players that matched when the selector was ambiguous. Never billed." }, "402": { "description": "Payment required" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref11" } } }, "description": "The selector resolved to no archived fixture / player / entity (coverage.reason_code = *_not_found). Never billed." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref11" } } }, "description": "Archive integrity error (coverage.reason_code = archive_error); nothing was served. Never billed." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref11" } } }, "description": "A valid selector for which the archive holds no row (coverage.reason_code = archive_row_missing). Retry later. Never billed." } }, "description": "Fixture-scoped provider evidence. An empty response does not prove complete historical injury coverage.", "requestBody": { "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_73629476a9a8422a_ref0" }, { "type": "object", "properties": { "league": { "enum": [ "", "1" ], "type": "string", "default": "1" }, "season": { "enum": [ "", "2026" ], "type": "string", "default": "2026" } } } ] }, "examples": { "fixture": { "value": { "event": "Brazil vs Morocco" } }, "captured": { "value": { "event": "Brazil vs Morocco" }, "summary": "Request used for the captured 200 example" } } } }, "required": true }, "x-zeroclick-document-sources": [ { "gaps": [], "pages": [], "sourceId": "sds_kS_Na0vlgH8jHcvZiy8eD", "authority": "official", "conflicts": [], "revisionId": "sdrn_IB5cI6fYy5LIS4OREpc2m" }, { "gaps": [ "Missing request body schema", "Missing parameter definitions" ], "pages": [ 1 ], "sourceId": "sds_lEILwU1VMqWXAvmNynqZQ", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description", "/description" ], "revisionId": "sdrn_-CuYe8y_ET60tB1VhI3Sl" }, { "gaps": [ "Missing request body schema", "Missing parameters" ], "pages": [ 1 ], "sourceId": "sds_pYBubIfmVitksSAV5O4y8", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description" ], "revisionId": "sdrn_18lH1kSa6dItqVVxgexAA" } ], "x-zeroclick-services": [ "match-context" ], "x-payment-info": { "access": "payg", "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "10000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.010000 per call (injuries, service match-context)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "rates": [ { "service": "match-context", "meter": "injuries", "unit": "call", "unitSize": 1, "priceUsd": "0.010000", "includedUnits": 0 } ], "perCallUsage": [ { "service": "match-context", "meter": "injuries", "quantity": 1 } ] } } }, "/world-cup/v1/get-match-forecast": { "post": { "summary": "Archived match forecast probabilities", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "data", "meta" ], "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref2" }, { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref10" } ] }, "meta": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref1" } ], "properties": { "code": { "const": 200 } } }, "status": { "const": "success" } }, "description": "Transport envelope as delivered by api.machina.gg and the ZeroClick storefront; `data` carries the endpoint payload." }, "examples": { "archived": { "value": { "data": { "archive": { "live": false, "mode": "final_archive", "notes": [ "Historical model output; forecast_integrity states whether its stored timestamp is genuinely pre-kickoff. No real-time refresh is performed.", "data_source=seed: the model's original pre-kickoff forecast, preserved as computed. No FIFA World Cup 2026 result existed yet for at least one side, so the Dixon-Coles model used the FIFA-ranking seed prior and `confidence` (0.15) reflects that. It is not a placeholder and nothing is recomputed at request time." ], "status": "hit", "version": "world-cup-2026-final-v3", "provenance": [ "worldcup:model-forecast", "fifa-ranking-seed", "worldcup:market-cache" ], "competition": "FIFA World Cup 2026", "snapshot_as_of": "2026-06-13T07:00:02.352497Z", "response_sha256": "5d4841a71813af43a98c86a056dfd5fb13652e596c00a84b8557f19082eace4e", "capability_status": "historical_model", "competition_status": "completed", "content_created_at": null, "source_observed_at": null, "timestamp_semantics": "original_model_computation", "missing_capabilities": [], "source_manifest_sha256": "1475d3e0bed784c99e9818a93ca08ea7b34fff96ad98a7e77504f12b6ec22877", "request_identity_sha256": "b4512cbddc62031e2f427358325049f091adc6f26b153772a02037f3b2c6d6aa" }, "analysis": {}, "coverage": { "mode": "historical", "scope": "completed_tournament_archive", "reason": "Original model output predates kickoff.", "status": "complete", "eligible_count": 1, "excluded_count": 0, "included_count": 1, "schema_version": "worldcup-storefront-coverage-v1", "population_count": 1, "exclusion_reasons": {}, "source_provenance": [ "worldcup:model-forecast", "fifa-ranking-seed", "worldcup:market-cache" ], "unsupported_fields": [ "verified_prematch_market_comparison" ] }, "forecast": { "id": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "@id": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "_id": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "flags": [ "bootstrap_seeded", "low_sample_size" ], "model": { "rho": -0.12, "method": "dixon_coles_analytic_stdlib", "computed_at": "2026-06-13T07:00:02.352497Z" }, "caveats": [ "Model probability is a form-based statistical estimate, not a market-calibrated forecast.", "Pre-tournament confidence is low: seeded from FIFA/qualifier form until group results land." ], "away_team": { "urn": "urn:machina:sport:soccer:team:morocco:mar", "name": "Morocco" }, "home_team": { "urn": "urn:machina:sport:soccer:team:brazil:bra", "name": "Brazil" }, "confidence": 0.15, "disclaimer": "Informational sports market intelligence only. Not betting, trading, financial, or investment advice.", "data_source": "seed", "provider_ids": { "api_football": "1489371" }, "probabilities": { "draw": 0.3256, "away_win": 0.2875, "home_win": 0.3869, "over_2_5": 0.3635, "under_2_5": 0.6365 }, "exact_scorelines": { "0-0": 0.1327, "0-1": 0.0979, "0-2": 0.0556, "1-0": 0.1207, "1-1": 0.1495, "1-2": 0.0652, "2-0": 0.0801, "2-1": 0.0783 }, "schema:startDate": "2026-06-13T22:00:00+00:00", "most_likely_score": "1-1", "away_expected_goals": 0.976, "home_expected_goals": 1.172 }, "warnings": [ "Market cache contains a snapshot at or after kickoff; edge claims are suppressed." ], "candidates": [ { "name": "Brazil vs Morocco - FIFA World Cup 2026", "round": "Group Stage - 1", "score": { "away": 1, "home": 1, "elapsed": 90 }, "stage": "Group Stage - 1", "teams": [ { "name": "Brazil", "crest": "https://media.api-sports.io/football/teams/6.png", "team_urn": "urn:machina:sport:soccer:team:brazil:bra", "qualifier": "home" }, { "name": "Morocco", "crest": "https://media.api-sports.io/football/teams/31.png", "team_urn": "urn:machina:sport:soccer:team:morocco:mar", "qualifier": "away" } ], "venue": "MetLife Stadium", "status": "ft", "event_urn": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "fixture_id": "1489371", "start_date": "2026-06-13T22:00:00+00:00", "competition": "FIFA World Cup 2026" } ], "model_vs_market": { "gaps": [], "count": 0, "caveats": [ "Model probability is a form-based statistical estimate, not a market-calibrated forecast.", "Pre-tournament confidence is low: seeded from FIFA/qualifier form until group results land.", "Gap is informational only, not a value or bet signal." ], "event_urn": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "disclaimer": "Informational sports market intelligence only. Not betting, trading, financial, or investment advice.", "max_gap_bps": 0, "min_gap_bps": 100, "market_integrity": { "classification": "settled_or_late_cache", "snapshot_times": [ "2026-06-10T21:31:52.390338+00:00", "2026-06-14T00:06:07.024791+00:00", "2026-06-14T00:06:07.024791+00:00" ], "valid_for_edge_comparison": false }, "comparison_status": "suppressed_invalid_snapshot_timing", "forecast_integrity": { "kickoff": "2026-06-13T22:00:00+00:00", "computed_at": "2026-06-13T07:00:02.352497Z", "classification": "verified_pre_kickoff", "verified_pre_kickoff": true } }, "market_integrity": { "classification": "settled_or_late_cache", "snapshot_times": [ "2026-06-10T21:31:52.390338+00:00", "2026-06-14T00:06:07.024791+00:00", "2026-06-14T00:06:07.024791+00:00" ], "valid_for_edge_comparison": false }, "forecast_integrity": { "kickoff": "2026-06-13T22:00:00+00:00", "computed_at": "2026-06-13T07:00:02.352497Z", "classification": "verified_pre_kickoff", "verified_pre_kickoff": true } }, "meta": { "code": 200 }, "status": "success" }, "summary": "Real 200 body captured from the production archive on 2026-09-18 (arrays trimmed to 3 items) — wrapped in the transport envelope {status, meta, data}" } } } }, "description": "Stored forecast with forecast and market integrity classifications." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref11" }, "examples": { "selector_required": { "value": { "data": {}, "meta": { "code": 400 }, "error": { "code": 400, "type": "selector_required", "billed": false, "archive": { "live": false, "mode": "final_archive", "notes": [ "A fixture selector is required: pass event_urn, provider_event_id, event (e.g. \"Brazil vs Morocco\"), or team with opponent/date." ], "status": "unavailable", "version": "world-cup-2026-final-v3", "provenance": [], "competition": "FIFA World Cup 2026", "reason_code": "fixture_selector_required", "snapshot_as_of": null, "capability_status": "unavailable", "competition_status": "completed", "missing_capabilities": [] }, "message": "A fixture selector is required: pass event_urn, provider_event_id, event (e.g. \"Brazil vs Morocco\"), or team with opponent/date.", "coverage": { "mode": "historical", "scope": "completed_tournament_archive", "reason": "A fixture selector is required: pass event_urn, provider_event_id, event (e.g. \"Brazil vs Morocco\"), or team with opponent/date.", "status": "unavailable", "reason_code": "fixture_selector_required", "eligible_count": null, "excluded_count": null, "included_count": null, "schema_version": "worldcup-storefront-coverage-v1", "accepted_fields": [ "event_urn", "provider_event_id", "event", "team", "opponent", "date", "include_reasoning", "min_gap_bps" ], "population_count": null, "exclusion_reasons": {}, "source_provenance": [], "unsupported_fields": [] }, "reason_code": "fixture_selector_required", "accepted_fields": [ "event_urn", "provider_event_id", "event", "team", "opponent", "date", "include_reasoning", "min_gap_bps" ] }, "status": "error" }, "summary": "Real body captured through the ZeroClick storefront (agents.machina.gg) on 2026-09-22: empty body" } } } }, "description": "The request did not identify what to answer about (coverage.reason_code = fixture_selector_required / fixture_ambiguous / player_selector_required / player_ambiguous / entity_selector_required / entity_ambiguous) or used a parameter variant outside the archive catalog (unsupported_parameter). `candidates` lists the fixtures/players that matched when the selector was ambiguous. Never billed." }, "402": { "description": "Payment required" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref11" } } }, "description": "The selector resolved to no archived fixture / player / entity (coverage.reason_code = *_not_found). Never billed." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref11" } } }, "description": "Archive integrity error (coverage.reason_code = archive_error); nothing was served. Never billed." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref11" } } }, "description": "A valid selector for which the archive holds no row (coverage.reason_code = archive_row_missing). Retry later. Never billed." } }, "description": "Preserves the stored model probabilities and computed_at timestamp. Reports whether the model predates kickoff; market gaps are suppressed unless the cache is a verifiable historical pre-match quote.", "requestBody": { "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_97fccdea54a42ef7_ref0" }, { "type": "object", "properties": { "min_gap_bps": { "type": "integer", "default": 100, "minimum": 0 }, "include_reasoning": { "type": "boolean", "default": false } } } ] }, "examples": { "captured": { "value": { "event": "Brazil vs Morocco" }, "summary": "Request used for the captured 200 example" }, "forecast": { "value": { "event_urn": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "include_reasoning": false } } } } }, "required": true }, "x-zeroclick-document-sources": [ { "gaps": [], "pages": [], "sourceId": "sds_kS_Na0vlgH8jHcvZiy8eD", "authority": "official", "conflicts": [], "revisionId": "sdrn_IB5cI6fYy5LIS4OREpc2m" }, { "gaps": [ "Missing request body schema", "Missing parameter definitions" ], "pages": [ 1 ], "sourceId": "sds_lEILwU1VMqWXAvmNynqZQ", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description", "/description" ], "revisionId": "sdrn_-CuYe8y_ET60tB1VhI3Sl" }, { "gaps": [ "Missing request body schema", "Missing parameters" ], "pages": [ 1 ], "sourceId": "sds_pYBubIfmVitksSAV5O4y8", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description" ], "revisionId": "sdrn_18lH1kSa6dItqVVxgexAA" } ], "x-zeroclick-services": [ "forecasts" ], "x-payment-info": { "access": "payg", "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "120000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.120000 per call (match_forecast, service forecasts)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.120000" }, "rates": [ { "service": "forecasts", "meter": "match_forecast", "unit": "call", "unitSize": 1, "priceUsd": "0.120000", "includedUnits": 0 } ], "perCallUsage": [ { "service": "forecasts", "meter": "match_forecast", "quantity": 1 } ] } } }, "/world-cup/v1/get-player-performance-context": { "post": { "summary": "Player performance context", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "data", "meta" ], "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref2" }, { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref10" } ] }, "meta": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref1" } ], "properties": { "code": { "const": 200 } } }, "status": { "const": "success" } }, "description": "Transport envelope as delivered by api.machina.gg and the ZeroClick storefront; `data` carries the endpoint payload." }, "examples": { "archived": { "value": { "data": { "status": "available", "archive": { "live": false, "mode": "final_archive", "notes": [ "One fixture-scoped pack; player selection occurs locally at read time." ], "status": "hit", "version": "world-cup-2026-final-v3", "provenance": [ "worldcup:event", "worldcup:identity-crosswalk", "fifa.com" ], "competition": "FIFA World Cup 2026", "snapshot_as_of": "2026-09-13T16:13:55Z", "response_sha256": "941107894b963538cc2fbdaa4bec0a9bf470e11824cc258b39c926638c75ab39", "capability_status": "complete", "competition_status": "completed", "content_created_at": null, "source_observed_at": "2026-09-13T16:13:55Z", "timestamp_semantics": "source_capture_observation", "missing_capabilities": [], "source_manifest_sha256": "ed7945514dabfe000756d9fa13348c66a57c834baaa0528f59860bf9e53819a8", "request_identity_sha256": "129d1151e0a3c396f2c2552958fe0320bb45b2a0452b18134b30104457fd21d2" }, "coverage": { "mode": "historical", "scope": "completed_tournament_archive", "reason": "Fixture participants preserve canonical URNs when evidenced and exact provider ids otherwise.", "status": "complete", "eligible_count": 51, "excluded_count": 0, "included_count": 51, "schema_version": "worldcup-storefront-coverage-v1", "population_count": 51, "exclusion_reasons": {}, "source_provenance": [ "worldcup:event", "worldcup:identity-crosswalk", "fifa.com" ], "unsupported_fields": [] }, "warnings": [], "candidates": [ { "name": "Brazil vs Morocco - FIFA World Cup 2026", "round": "Group Stage - 1", "score": { "away": 1, "home": 1, "elapsed": 90 }, "stage": "Group Stage - 1", "teams": [ { "name": "Brazil", "crest": "https://media.api-sports.io/football/teams/6.png", "team_urn": "urn:machina:sport:soccer:team:brazil:bra", "qualifier": "home" }, { "name": "Morocco", "crest": "https://media.api-sports.io/football/teams/31.png", "team_urn": "urn:machina:sport:soccer:team:morocco:mar", "qualifier": "away" } ], "venue": "MetLife Stadium", "status": "ft", "event_urn": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "fixture_id": "1489371", "start_date": "2026-06-13T22:00:00+00:00", "competition": "FIFA World Cup 2026" } ], "identity_coverage": { "canonical_count": 51, "provider_only_count": 0, "ambiguous_omitted_count": 0 }, "player_candidates": [ { "name": "Vinícius Júnior", "team": "Brazil", "player_urn": "urn:machina:sport:soccer:player:vinicius:20000712:bra", "provider_ids": { "espn": "252107", "api_football": "762" } } ], "fixture_player_pack": { "event_urn": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "fixture_id": "1489371", "player_count": 51 }, "player_performance_context": { "event": { "id": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "@id": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "_id": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "name": "Brazil vs Morocco - FIFA World Cup 2026", "@type": [ "sport:Event", "schema:SportsEvent" ], "round": "Group Stage - 1", "stage": "Group Stage - 1", "@context": { "sport": "https://www.sportschema.org/ontologies/sport#", "schema": "https://schema.org/", "machina": "https://schema.machina.gg/sports#" }, "live_score": { "away": 1, "home": 1, "elapsed": 90 }, "sport:venue": { "@id": "urn:machina:sport:soccer:venue:metlife-stadium:eas", "name": "MetLife Stadium", "@type": "sport:Venue", "schema:addressLocality": "East Rutherford" }, "provider_ids": { "opta": "ar8b186wqraa80u0vpi2e4nis", "entain": "7722038", "sportradar": "sr:sport_event:66456928", "api_football": "1489371" }, "sport:status": "FT", "schema:startDate": "2026-06-13T22:00:00+00:00", "sport:competition": { "@id": "urn:machina:sport:soccer:competition:fifa-world-cup-2026:wor", "name": "FIFA World Cup 2026", "@type": "sport:Competition" }, "sport:competitors": [ { "@id": "urn:machina:sport:soccer:team:brazil:bra", "name": "Brazil", "@type": "sport:Team", "schema:logo": "https://media.api-sports.io/football/teams/6.png", "sport:qualifier": "home" }, { "@id": "urn:machina:sport:soccer:team:morocco:mar", "name": "Morocco", "@type": "sport:Team", "schema:logo": "https://media.api-sports.io/football/teams/31.png", "sport:qualifier": "away" } ], "machina_competition_slug": "world-cup-2026" }, "player": { "name": "Vinícius Júnior", "team_id": "6", "position": "M", "player_id": "762", "team_name": "Brazil", "is_goalkeeper": false, "minutes_played": 90, "minutes_evidence": true, "eligible_for_power_ranking": true }, "context_and_evidence": { "citations": [], "freshness": { "provider_stats_fetched": true, "official_fifa_expected_lag_hours": 4 }, "fallback_path": [ "api-football" ], "missing_info_flags": [] }, "official_fifa_power_ranking": { "scores": { "attacking": 6.992136478424072, "defending": 4.667199611663818, "creativity": 6.836964130401611, "in_possession": null, "defending_goal": null }, "source": "fifa.com", "status": "available", "player_type": "outfield", "classification": { "match_rank": null, "tournament_rank": null, "category_rankings": [ { "rank": 7, "score": 6.992136478424072, "category": "attacking", "rank_change": 0, "rank_within_team": 1 }, { "rank": 16, "score": 6.836964130401611, "category": "creativity", "rank_change": -1, "rank_within_team": 1 }, { "rank": 262, "score": 4.667199611663818, "category": "defending", "rank_change": 11, "rank_within_team": 10 } ] }, "source_snapshot": { "url": "https://fdh-api.fifa.com/v1/powerranking/season/285023.json", "counts": { "goalkeepers": 28, "outfield_players": 202, "published_players": 230 }, "sha256": "5192eeb55a3b9a957f1f3951a0c757b00da608a3bcb10a13641627fb14dc0735", "nMatches": 104, "fetched_at": "2026-09-01T04:33:26.737126Z", "competitionId": 285023, "messageTimeUtc": "2026-07-20T00:28:49.92294Z", "competitionStage": "Final" }, "expected_available_at": null }, "machina_provisional_performance_signal": { "status": "available", "drivers": [ { "signal": "goals/assists/shots/rating", "source": "provider", "weight": 6.75, "category": "attacking", "direction": "positive" }, { "signal": "assists/key passes/pass accuracy", "source": "provider", "weight": 4.72, "category": "creativity", "direction": "positive" }, { "signal": "tackles/interceptions/duels/cards", "source": "provider", "weight": 3.85, "category": "defending", "direction": "positive" } ], "warnings": [], "confidence": 0.9, "disclaimer": "Machina provisional signal only; not an official FIFA Power Ranking.", "scores_0_10": { "attacking": 6.75, "defending": 4.28, "creativity": 5.24, "in_possession": null, "defending_goal": null }, "source_quality": "provider" } } }, "meta": { "code": 200 }, "status": "success" }, "summary": "Real 200 body captured from the production archive on 2026-09-18 (arrays trimmed to 3 items) — wrapped in the transport envelope {status, meta, data}" } } } }, "description": "Explicit player context or unavailable/ambiguous evidence status." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref11" }, "examples": { "player_selector_required": { "value": { "data": {}, "meta": { "code": 400 }, "error": { "code": 400, "type": "selector_required", "billed": false, "archive": { "live": false, "mode": "final_archive", "notes": [ "A player selector is required for the fixture player pack." ], "status": "unavailable", "version": "world-cup-2026-final-v3", "provenance": [], "competition": "FIFA World Cup 2026", "reason_code": "player_selector_required", "snapshot_as_of": null, "capability_status": "unavailable", "competition_status": "completed", "missing_capabilities": [] }, "message": "A player selector is required for the fixture player pack.", "coverage": { "mode": "historical", "scope": "completed_tournament_archive", "reason": "A player selector is required for the fixture player pack.", "status": "unavailable", "reason_code": "player_selector_required", "eligible_count": null, "excluded_count": null, "included_count": null, "schema_version": "worldcup-storefront-coverage-v1", "accepted_fields": [ "event_urn", "provider_event_id", "event", "team", "opponent", "date", "player_urn", "player_id", "player", "team_id" ], "population_count": null, "exclusion_reasons": {}, "source_provenance": [], "unsupported_fields": [] }, "reason_code": "player_selector_required", "accepted_fields": [ "event_urn", "provider_event_id", "event", "team", "opponent", "date", "player_urn", "player_id", "player", "team_id" ] }, "status": "error" }, "summary": "Real body captured through the ZeroClick storefront (agents.machina.gg) on 2026-09-22: body {\"event\":\"Brazil vs Morocco\"} without a player selector" }, "fixture_selector_required": { "value": { "data": {}, "meta": { "code": 400 }, "error": { "code": 400, "type": "selector_required", "billed": false, "archive": { "live": false, "mode": "final_archive", "notes": [ "A fixture selector is required: pass event_urn, provider_event_id, event (e.g. \"Brazil vs Morocco\"), or team with opponent/date." ], "status": "unavailable", "version": "world-cup-2026-final-v3", "provenance": [], "competition": "FIFA World Cup 2026", "reason_code": "fixture_selector_required", "snapshot_as_of": null, "capability_status": "unavailable", "competition_status": "completed", "missing_capabilities": [] }, "message": "A fixture selector is required: pass event_urn, provider_event_id, event (e.g. \"Brazil vs Morocco\"), or team with opponent/date.", "coverage": { "mode": "historical", "scope": "completed_tournament_archive", "reason": "A fixture selector is required: pass event_urn, provider_event_id, event (e.g. \"Brazil vs Morocco\"), or team with opponent/date.", "status": "unavailable", "reason_code": "fixture_selector_required", "eligible_count": null, "excluded_count": null, "included_count": null, "schema_version": "worldcup-storefront-coverage-v1", "accepted_fields": [ "event_urn", "provider_event_id", "event", "team", "opponent", "date", "player_urn", "player_id", "player", "team_id" ], "population_count": null, "exclusion_reasons": {}, "source_provenance": [], "unsupported_fields": [] }, "reason_code": "fixture_selector_required", "accepted_fields": [ "event_urn", "provider_event_id", "event", "team", "opponent", "date", "player_urn", "player_id", "player", "team_id" ] }, "status": "error" }, "summary": "Real body captured through the ZeroClick storefront (agents.machina.gg) on 2026-09-22: empty body" } } } }, "description": "The request did not identify what to answer about (coverage.reason_code = fixture_selector_required / fixture_ambiguous / player_selector_required / player_ambiguous / entity_selector_required / entity_ambiguous) or used a parameter variant outside the archive catalog (unsupported_parameter). `candidates` lists the fixtures/players that matched when the selector was ambiguous. Never billed." }, "402": { "description": "Payment required" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref11" } } }, "description": "The selector resolved to no archived fixture / player / entity (coverage.reason_code = *_not_found). Never billed." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref11" } } }, "description": "Archive integrity error (coverage.reason_code = archive_error); nothing was served. Never billed." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref11" } } }, "description": "A valid selector for which the archive holds no row (coverage.reason_code = archive_row_missing). Retry later. Never billed." } }, "description": "Fixture-scoped player evidence with explicit player identity. Official FIFA values remain separate from Machina provisional estimates; ambiguous names return candidates.", "requestBody": { "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_8726e28dde30981f_ref0" }, { "type": "object", "anyOf": [ { "required": [ "player_urn" ] }, { "required": [ "player" ] }, { "required": [ "player_id" ] } ], "properties": { "player": { "type": "string" }, "team_id": { "type": "string" }, "player_id": { "type": "string" }, "player_urn": { "type": "string" } } } ] }, "examples": { "captured": { "value": { "team": "Brazil", "event": "Brazil vs Morocco", "player": "Vinicius Junior" }, "summary": "Request used for the captured 200 example" }, "namedPlayer": { "value": { "team": "Brazil", "event": "Brazil vs Morocco", "player": "Vinicius Junior" } } } } }, "required": true }, "x-zeroclick-document-sources": [ { "gaps": [], "pages": [], "sourceId": "sds_kS_Na0vlgH8jHcvZiy8eD", "authority": "official", "conflicts": [], "revisionId": "sdrn_IB5cI6fYy5LIS4OREpc2m" }, { "gaps": [ "Missing request body schema", "Missing parameter definitions" ], "pages": [ 1 ], "sourceId": "sds_lEILwU1VMqWXAvmNynqZQ", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description", "/description" ], "revisionId": "sdrn_-CuYe8y_ET60tB1VhI3Sl" }, { "gaps": [ "Missing request body schema", "Missing parameters" ], "pages": [ 1 ], "sourceId": "sds_pYBubIfmVitksSAV5O4y8", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description" ], "revisionId": "sdrn_18lH1kSa6dItqVVxgexAA" } ], "x-zeroclick-services": [ "match-context" ], "x-payment-info": { "access": "payg", "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "10000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.010000 per call (player_performance, service match-context)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "rates": [ { "service": "match-context", "meter": "player_performance", "unit": "call", "unitSize": 1, "priceUsd": "0.010000", "includedUnits": 0 } ], "perCallUsage": [ { "service": "match-context", "meter": "player_performance", "quantity": 1 } ] } } }, "/world-cup/v1/get-schedule": { "post": { "summary": "Tournament fixtures", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "data", "meta" ], "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref1" }, { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref9" } ] }, "meta": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref0" } ], "properties": { "code": { "const": 200 } } }, "status": { "const": "success" } }, "description": "Transport envelope as delivered by api.machina.gg and the ZeroClick storefront; `data` carries the endpoint payload." }, "examples": { "archived": { "value": { "data": { "archive": { "live": false, "mode": "final_archive", "notes": [ "Immutable 104-fixture final schedule." ], "status": "hit", "version": "world-cup-2026-final-v3", "provenance": [ "worldcup:event", "api-football" ], "competition": "FIFA World Cup 2026", "snapshot_as_of": "2026-09-13T17:08:22.003454Z", "response_sha256": "fa3d782d490b141aa4291c1034028e636bd0fdb7b0e377efc24cb4fcc8aab61d", "capability_status": "complete", "competition_status": "completed", "content_created_at": null, "source_observed_at": "2026-09-13T17:08:22.003454Z", "timestamp_semantics": "source_capture_observation", "missing_capabilities": [], "source_manifest_sha256": "22b08ee7825cf62ad54fad0efadc89532c9cbb3b74f0e635821c244fbec4cb87", "request_identity_sha256": "0d0d7407b450bf6a65fd0dfac99f6c6c1a6e17bab23f6b4ab500774853af64f5" }, "coverage": { "mode": "historical", "scope": "completed_tournament_archive", "reason": "All canonical tournament fixtures and verified result details are included.", "status": "complete", "eligible_count": 104, "excluded_count": 0, "included_count": 104, "schema_version": "worldcup-storefront-coverage-v1", "population_count": 104, "exclusion_reasons": {}, "source_provenance": [ "worldcup:event", "api-football" ], "unsupported_fields": [] }, "schedule": { "count": 5, "limit": 104, "events": [ { "name": "Brazil vs Morocco - FIFA World Cup 2026", "round": "Group Stage - 1", "score": { "away": 1, "home": 1, "elapsed": 90 }, "stage": "Group Stage - 1", "teams": [ { "name": "Brazil", "crest": "https://media.api-sports.io/football/teams/6.png", "team_urn": "urn:machina:sport:soccer:team:brazil:bra", "qualifier": "home" }, { "name": "Morocco", "crest": "https://media.api-sports.io/football/teams/31.png", "team_urn": "urn:machina:sport:soccer:team:morocco:mar", "qualifier": "away" } ], "venue": "MetLife Stadium", "status": "ft", "event_urn": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "fixture_id": "1489371", "start_date": "2026-06-13T22:00:00+00:00", "competition": "FIFA World Cup 2026", "result_details": { "status": "FT", "winner": null, "fixture_id": "1489371", "provenance": { "provider": "api-football", "capture_id": "6aa6d8852677921cf5d5f48e", "fixture_id": "1489371", "source_url": "https://www.api-football.com/", "observed_at": "2026-09-13T17:08:22.003454Z", "capture_name": "worldcup-archive-capture-results", "capture_sha256": "10522211a9442626d08c603aa9a01c4c3afe3ae2dfc7217e0e7e2290c5e85406", "provider_result_sha256": "9fb8564dae34abe16550eee706bd060efd31c24899c005231b4ae5f7ac7d9a55" }, "schema_version": "worldcup-result-details-v1", "shootout_score": null, "regulation_time_score": { "away": 1, "home": 1 }, "extra_time_score_contribution": null } }, { "name": "Brazil vs Haiti - FIFA World Cup 2026", "round": "Group Stage - 2", "score": { "away": 0, "home": 3, "elapsed": 90 }, "stage": "Group Stage - 2", "teams": [ { "name": "Brazil", "crest": "https://media.api-sports.io/football/teams/6.png", "team_urn": "urn:machina:sport:soccer:team:brazil:bra", "qualifier": "home" }, { "name": "Haiti", "crest": "https://media.api-sports.io/football/teams/2386.png", "team_urn": "urn:machina:sport:soccer:team:haiti:hti", "qualifier": "away" } ], "venue": "Lincoln Financial Field", "status": "ft", "event_urn": "urn:machina:sport:soccer:event:brazil-vs-haiti:20260620:wor", "fixture_id": "1489389", "start_date": "2026-06-20T00:30:00+00:00", "competition": "FIFA World Cup 2026", "result_details": { "status": "FT", "winner": { "name": "Brazil", "team_id": "6", "qualifier": "home" }, "fixture_id": "1489389", "provenance": { "provider": "api-football", "capture_id": "6aa6d8852677921cf5d5f48e", "fixture_id": "1489389", "source_url": "https://www.api-football.com/", "observed_at": "2026-09-13T17:08:22.003454Z", "capture_name": "worldcup-archive-capture-results", "capture_sha256": "10522211a9442626d08c603aa9a01c4c3afe3ae2dfc7217e0e7e2290c5e85406", "provider_result_sha256": "79ee04ca0772c4ff778c754ce7d34930936aea20e5f49378380df1d96afdac64" }, "schema_version": "worldcup-result-details-v1", "shootout_score": null, "regulation_time_score": { "away": 0, "home": 3 }, "extra_time_score_contribution": null } }, { "name": "Scotland vs Brazil - FIFA World Cup 2026", "round": "Group Stage - 3", "score": { "away": 3, "home": 0, "elapsed": 90 }, "stage": "Group Stage - 3", "teams": [ { "name": "Scotland", "crest": "https://media.api-sports.io/football/teams/1108.png", "team_urn": "urn:machina:sport:soccer:team:scotland:sco", "qualifier": "home" }, { "name": "Brazil", "crest": "https://media.api-sports.io/football/teams/6.png", "team_urn": "urn:machina:sport:soccer:team:brazil:bra", "qualifier": "away" } ], "venue": "Hard Rock Stadium", "status": "ft", "event_urn": "urn:machina:sport:soccer:event:scotland-vs-brazil:20260624:wor", "fixture_id": "1489406", "start_date": "2026-06-24T22:00:00+00:00", "competition": "FIFA World Cup 2026", "result_details": { "status": "FT", "winner": { "name": "Brazil", "team_id": "6", "qualifier": "away" }, "fixture_id": "1489406", "provenance": { "provider": "api-football", "capture_id": "6aa6d8852677921cf5d5f48e", "fixture_id": "1489406", "source_url": "https://www.api-football.com/", "observed_at": "2026-09-13T17:08:22.003454Z", "capture_name": "worldcup-archive-capture-results", "capture_sha256": "10522211a9442626d08c603aa9a01c4c3afe3ae2dfc7217e0e7e2290c5e85406", "provider_result_sha256": "de9bf94014a143b8d32558cba8083a43302255b9fafb0f898c0d6adca23e46b1" }, "schema_version": "worldcup-result-details-v1", "shootout_score": null, "regulation_time_score": { "away": 3, "home": 0 }, "extra_time_score_contribution": null } } ], "offset": 0, "has_more": false, "warnings": [], "truncated": false, "total_count": 5 }, "warnings": [] }, "meta": { "code": 200 }, "status": "success" }, "summary": "Real 200 body captured from the production archive on 2026-09-18 (arrays trimmed to 3 items) — wrapped in the transport envelope {status, meta, data}" } } } }, "description": "Archived fixture list with canonical and provider ids." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref10" } } }, "description": "The request did not identify what to answer about (coverage.reason_code = fixture_selector_required / fixture_ambiguous / player_selector_required / player_ambiguous / entity_selector_required / entity_ambiguous) or used a parameter variant outside the archive catalog (unsupported_parameter). `candidates` lists the fixtures/players that matched when the selector was ambiguous. Never billed." }, "402": { "description": "Payment required" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref10" } } }, "description": "The selector resolved to no archived fixture / player / entity (coverage.reason_code = *_not_found). Never billed." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref10" } } }, "description": "Archive integrity error (coverage.reason_code = archive_error); nothing was served. Never billed." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_0d26eca2bd8c666e_ref10" } } }, "description": "A valid selector for which the archive holds no row (coverage.reason_code = archive_row_missing). Retry later. Never billed." } }, "description": "All 104 archived World Cup 2026 fixtures and final results, filterable by team, opponent, status, and inclusive date range with bounded offset pagination.", "operationId": "getSchedule", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "team": { "type": "string" }, "limit": { "type": "integer", "default": 104, "maximum": 500, "minimum": 1 }, "offset": { "type": "integer", "default": 0, "minimum": 0 }, "status": { "enum": [ "FT", "AET", "PEN", "ft", "aet", "pen" ], "type": "string" }, "date_to": { "type": "string", "format": "date" }, "opponent": { "type": "string" }, "date_from": { "type": "string", "format": "date" } } }, "examples": { "captured": { "value": { "team": "Brazil" }, "summary": "Request used for the captured 200 example" }, "allFixtures": { "value": {} }, "teamSchedule": { "value": { "team": "Brazil", "limit": 25, "offset": 0 } } } } }, "required": false }, "x-zeroclick-document-sources": [ { "gaps": [], "pages": [], "sourceId": "sds_kS_Na0vlgH8jHcvZiy8eD", "authority": "official", "conflicts": [], "revisionId": "sdrn_IB5cI6fYy5LIS4OREpc2m" }, { "gaps": [], "pages": [ 1 ], "sourceId": "sds_CRV8I05_3KT7tUQjkuusg", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description", "/description", "/requestBody/required" ], "revisionId": "sdrn_ZjJllMESmSJWIjacSawNt" }, { "gaps": [ "Missing request body schema", "Missing parameter definitions" ], "pages": [ 1 ], "sourceId": "sds_lEILwU1VMqWXAvmNynqZQ", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description", "/description" ], "revisionId": "sdrn_-CuYe8y_ET60tB1VhI3Sl" }, { "gaps": [ "Missing request body schema", "Missing parameters" ], "pages": [ 1 ], "sourceId": "sds_pYBubIfmVitksSAV5O4y8", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description" ], "revisionId": "sdrn_18lH1kSa6dItqVVxgexAA" } ], "x-zeroclick-services": [ "match-context" ], "x-payment-info": { "access": "payg", "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "10000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.010000 per call (schedule, service match-context)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "rates": [ { "service": "match-context", "meter": "schedule", "unit": "call", "unitSize": 1, "priceUsd": "0.010000", "includedUnits": 0 } ], "perCallUsage": [ { "service": "match-context", "meter": "schedule", "quantity": 1 } ] } } }, "/world-cup/v1/get-squads": { "post": { "summary": "Archived tournament squad identities", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "data", "meta" ], "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref2" }, { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref14" } ] }, "meta": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref1" } ], "properties": { "code": { "const": 200 } } }, "status": { "const": "success" } }, "description": "Transport envelope as delivered by api.machina.gg and the ZeroClick storefront; `data` carries the endpoint payload." }, "examples": { "archived": { "value": { "data": { "squads": { "teams": [ { "side": "home", "team": "Brazil", "count": 26, "source": "worldcup:identity-crosswalk", "players": [ { "name": "Alex Sandro", "position": "Defender", "birth_date": "1991-01-26", "player_urn": "urn:machina:sport:soccer:player:alex-sandro:19910126:bra", "nationality": "Brazil", "provider_ids": { "espn": "125514", "api_football": "860" }, "source_timestamp": "2026-06-05 17:34:28+00:00" }, { "name": "Alisson Becker", "position": "Goalkeeper", "birth_date": "1992-10-02", "player_urn": "urn:machina:sport:soccer:player:alisson-becker:19921002:bra", "nationality": "Brazil", "provider_ids": { "espn": "196876", "api_football": "280" }, "source_timestamp": "2026-06-05 17:34:28+00:00" }, { "name": "Bruno Guimarães", "position": "Midfielder", "birth_date": "1997-11-16", "player_urn": "urn:machina:sport:soccer:player:bruno-guimaraes:19971116:bra", "nationality": "Brazil", "provider_ids": { "espn": "218522", "api_football": "10135" }, "source_timestamp": "2026-06-05 17:34:28+00:00" } ], "team_urn": "urn:machina:sport:soccer:team:brazil:bra", "team_identity": { "name": "Brazil", "team_urn": "urn:machina:sport:soccer:team:brazil:bra", "provider_ids": { "espn": "205", "api_football": "6" }, "source_timestamp": "2026-06-05 04:22:08+00:00" } }, { "side": "away", "team": "Morocco", "count": 27, "source": "worldcup:identity-crosswalk", "players": [ { "name": "Abdessamad Ezzalzouli", "position": "Midfielder", "birth_date": "2001-12-17", "player_urn": "urn:machina:sport:soccer:player:abdessamad-ezzalzouli:20011217:mar", "nationality": "Morocco", "provider_ids": { "espn": "300912", "api_football": "181421" }, "source_timestamp": "2026-06-05 17:34:28+00:00" }, { "name": "Achraf Hakimi Mouh", "position": "Defender", "birth_date": "1998-11-04", "player_urn": "urn:machina:sport:soccer:player:achraf-hakimi-mouh:19981104:mar", "nationality": "Morocco", "provider_ids": { "espn": "240233", "api_football": "9" }, "source_timestamp": "2026-06-05 17:34:28+00:00" }, { "name": "Ahmed Reda Tagnaouti", "position": "Goalkeeper", "birth_date": "1996-04-05", "player_urn": "urn:machina:sport:soccer:player:ahmed-reda-tagnaouti:19960405:mar", "nationality": "Morocco", "provider_ids": { "espn": "195240", "api_football": "2703" }, "source_timestamp": "2026-06-05 17:34:28+00:00" } ], "team_urn": "urn:machina:sport:soccer:team:morocco:mar", "team_identity": { "name": "Morocco", "team_urn": "urn:machina:sport:soccer:team:morocco:mar", "provider_ids": { "espn": "2869", "api_football": "31" }, "source_timestamp": "2026-06-05 04:22:08+00:00" } } ], "warnings": [ "Persisted tournament identities are evidence of the archived player pool, not proof of a complete official FIFA squad registration." ], "competition": "FIFA World Cup 2026", "snapshot_type": "archived_tournament_identity_snapshot", "evidence_status": "observed_tournament_player_pool", "observed_player_count": 53, "official_registration_status": "verified_final_published_snapshot", "official_registration_snapshot": { "scope": "final_published_tournament_roster_snapshot", "teams": [ { "source": { "url": "https://fdp.fifa.org/assetspublic/ce281/pdf/SquadLists-English.pdf", "page": 7, "sha256": "02a0a9beb5d219e7cc0aedde19273e9a3bfe4818ecd600d37804b8801dd96d94", "publisher": "FIFA", "published_at": "2026-07-19T22:34:35+00:00" }, "players": [ { "club_raw": "Liverpool FC (ENG)", "warnings": [], "height_cm": 193, "team_name": "Brazil", "birth_date": "1992-10-02", "source_page": 7, "provider_ids": { "espn": "196876", "api_football": "280" }, "canonical_urn": "urn:machina:sport:soccer:player:alisson-becker:19921002:bra", "jersey_number": 1, "position_code": "GK", "fifa_team_code": "BRA", "last_names_raw": "BECKER", "shirt_name_raw": "A. BECKER", "first_names_raw": "Álisson Ramsés", "player_name_raw": "ALISSON", "provider_id_aliases": {}, "canonical_birth_date": "1992-10-02", "identity_mapping_status": "official_reconciled", "canonical_birth_date_conflict": false, "international_caps_as_reported": 83, "international_goals_as_reported": 0 }, { "club_raw": "Atalanta Bergamo (ITA)", "warnings": [], "height_cm": 184, "team_name": "Brazil", "birth_date": "1999-07-07", "source_page": 7, "provider_ids": { "api_football": "10097" }, "canonical_urn": "urn:machina:sport:soccer:player:ederson-silva:19990707:bra", "jersey_number": 2, "position_code": "MF", "fifa_team_code": "BRA", "last_names_raw": "DOS SANTOS LOURENÇO DA SILVA", "shirt_name_raw": "ÉDERSON S.", "first_names_raw": "Éderson José", "player_name_raw": "EDERSON SILVA", "provider_id_aliases": {}, "canonical_birth_date": "1999-07-07", "identity_mapping_status": "official_reconciled", "canonical_birth_date_conflict": false, "international_caps_as_reported": 5, "international_goals_as_reported": 0 }, { "club_raw": "Arsenal FC (ENG)", "warnings": [], "height_cm": 190, "team_name": "Brazil", "birth_date": "1997-12-19", "source_page": 7, "provider_ids": { "espn": "236322", "api_football": "22224" }, "canonical_urn": "urn:machina:sport:soccer:player:gabriel-magalhaes:19971219:bra", "jersey_number": 3, "position_code": "DF", "fifa_team_code": "BRA", "last_names_raw": "DOS SANTOS MAGALHÃES", "shirt_name_raw": "GABRIEL", "first_names_raw": "Gabriel", "player_name_raw": "GABRIEL MAGALHAES", "provider_id_aliases": {}, "canonical_birth_date": "1997-12-19", "identity_mapping_status": "official_reconciled", "canonical_birth_date_conflict": false, "international_caps_as_reported": 22, "international_goals_as_reported": 1 } ], "team_name": "Brazil", "source_page": 7, "completeness": { "status": "complete_for_published_snapshot", "expected_players": 26, "included_players": 26 }, "player_count": 26, "fifa_team_code": "BRA" }, { "source": { "url": "https://fdp.fifa.org/assetspublic/ce281/pdf/SquadLists-English.pdf", "page": 29, "sha256": "02a0a9beb5d219e7cc0aedde19273e9a3bfe4818ecd600d37804b8801dd96d94", "publisher": "FIFA", "published_at": "2026-07-19T22:34:35+00:00" }, "players": [ { "club_raw": "Al Hilal SC (KSA)", "warnings": [], "height_cm": 192, "team_name": "Morocco", "birth_date": "1991-04-05", "source_page": 29, "provider_ids": { "espn": "175149", "api_football": "2701" }, "canonical_urn": "urn:machina:sport:soccer:player:yassine-bounou:19910405:mar", "jersey_number": 1, "position_code": "GK", "fifa_team_code": "MAR", "last_names_raw": "BOUNOU", "shirt_name_raw": "BONO", "first_names_raw": "Yassine", "player_name_raw": "BOUNOU Yassine", "provider_id_aliases": {}, "canonical_birth_date": "1991-04-05", "identity_mapping_status": "official_reconciled", "canonical_birth_date_conflict": false, "international_caps_as_reported": 96, "international_goals_as_reported": 0 }, { "club_raw": "Paris Saint-Germain (FRA)", "warnings": [], "height_cm": 180, "team_name": "Morocco", "birth_date": "1998-11-04", "source_page": 29, "provider_ids": { "espn": "240233", "api_football": "9" }, "canonical_urn": "urn:machina:sport:soccer:player:achraf-hakimi-mouh:19981104:mar", "jersey_number": 2, "position_code": "DF", "fifa_team_code": "MAR", "last_names_raw": "HAKIMI", "shirt_name_raw": "HAKIMI", "first_names_raw": "Achraf", "player_name_raw": "HAKIMI Achraf", "provider_id_aliases": {}, "canonical_birth_date": "1998-11-04", "identity_mapping_status": "official_reconciled", "canonical_birth_date_conflict": false, "international_caps_as_reported": 102, "international_goals_as_reported": 12 }, { "club_raw": "Manchester United FC (ENG)", "warnings": [], "height_cm": 183, "team_name": "Morocco", "birth_date": "1997-11-14", "source_page": 29, "provider_ids": { "espn": "239350", "api_football": "545" }, "canonical_urn": "urn:machina:sport:soccer:player:noussair-mazraoui:19971114:mar", "jersey_number": 3, "position_code": "DF", "fifa_team_code": "MAR", "last_names_raw": "MAZRAOUI", "shirt_name_raw": "MAZRAOUI", "first_names_raw": "Noussair", "player_name_raw": "MAZRAOUI Noussair", "provider_id_aliases": {}, "canonical_birth_date": "1997-11-14", "identity_mapping_status": "official_reconciled", "canonical_birth_date_conflict": false, "international_caps_as_reported": 51, "international_goals_as_reported": 2 } ], "team_name": "Morocco", "source_page": 29, "completeness": { "status": "complete_for_published_snapshot", "expected_players": 26, "included_players": 26 }, "player_count": 26, "fifa_team_code": "MAR" } ], "source_url": "https://fdp.fifa.org/assetspublic/ce281/pdf/SquadLists-English.pdf", "limitations": [ "This final published snapshot is not a fixture-date lineup, eligibility, or replacement history.", "The FIFA registration snapshot does not certify injury status.", "International caps and goals are FIFA-reported totals, not World Cup match statistics." ], "completeness": { "status": "complete_for_published_snapshot", "included_teams": 2, "requested_teams": 2 }, "published_at": "2026-07-19T22:34:35+00:00", "source_sha256": "02a0a9beb5d219e7cc0aedde19273e9a3bfe4818ecd600d37804b8801dd96d94", "players_per_team": 26, "snapshot_team_count": 48 } }, "archive": { "live": false, "mode": "final_archive", "notes": [ "Archived tournament identity snapshot; not proof of complete FIFA squad registration.", "Official FIFA registration is complete for the published snapshot and distinct from fixture-date availability." ], "status": "hit", "version": "world-cup-2026-final-v3", "provenance": [ "worldcup:identity-crosswalk", "fifa.com:official-registration" ], "competition": "FIFA World Cup 2026", "snapshot_as_of": "2026-09-13T16:13:50Z", "response_sha256": "38782744e385ec4761fcaed1ef2f2ef6471cf49386a106113731f674d525e0ba", "capability_status": "partial", "competition_status": "completed", "content_created_at": "2026-06-16 06:08:31+00:00", "source_observed_at": "2026-09-13T16:13:50Z", "timestamp_semantics": "source_capture_observation", "missing_capabilities": [], "source_manifest_sha256": "b514fcfb3c8c0a9d39f0441d163022116873e27ee85b61c947f9b86a4a2f343b", "request_identity_sha256": "cdc34bdf147c6c7cd19787cdab81644856556ccbd932ba7f3167c99eb79da8ec" }, "coverage": { "mode": "historical", "scope": "completed_tournament_archive", "reason": "Both fixture teams have complete 26-player rosters in the final published FIFA snapshot; observed pools remain separate.", "status": "complete", "eligible_count": 52, "excluded_count": 0, "included_count": 52, "schema_version": "worldcup-storefront-coverage-v1", "population_count": 52, "exclusion_reasons": {}, "source_provenance": [ "worldcup:identity-crosswalk", "fifa.com:official-registration" ], "unsupported_fields": [ "complete_replacement_history", "fixture_date_lineup_or_eligibility", "injury_certification" ] }, "warnings": [ "Persisted tournament identities are evidence of the archived player pool, not proof of a complete official FIFA squad registration." ], "candidates": [ { "name": "Brazil vs Morocco - FIFA World Cup 2026", "round": "Group Stage - 1", "score": { "away": 1, "home": 1, "elapsed": 90 }, "stage": "Group Stage - 1", "teams": [ { "name": "Brazil", "crest": "https://media.api-sports.io/football/teams/6.png", "team_urn": "urn:machina:sport:soccer:team:brazil:bra", "qualifier": "home" }, { "name": "Morocco", "crest": "https://media.api-sports.io/football/teams/31.png", "team_urn": "urn:machina:sport:soccer:team:morocco:mar", "qualifier": "away" } ], "venue": "MetLife Stadium", "status": "ft", "event_urn": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "fixture_id": "1489371", "start_date": "2026-06-13T22:00:00+00:00", "competition": "FIFA World Cup 2026" } ] }, "meta": { "code": 200 }, "status": "success" }, "summary": "Real 200 body captured from the production archive on 2026-09-18 (arrays trimmed to 3 items) — wrapped in the transport envelope {status, meta, data}" } } } }, "description": "Both team identities and linked persisted tournament players with original timestamps." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref15" }, "examples": { "selector_required": { "value": { "data": {}, "meta": { "code": 400 }, "error": { "code": 400, "type": "selector_required", "billed": false, "archive": { "live": false, "mode": "final_archive", "notes": [ "A fixture selector is required: pass event_urn, provider_event_id, event (e.g. \"Brazil vs Morocco\"), or team with opponent/date." ], "status": "unavailable", "version": "world-cup-2026-final-v3", "provenance": [], "competition": "FIFA World Cup 2026", "reason_code": "fixture_selector_required", "snapshot_as_of": null, "capability_status": "unavailable", "competition_status": "completed", "missing_capabilities": [] }, "message": "A fixture selector is required: pass event_urn, provider_event_id, event (e.g. \"Brazil vs Morocco\"), or team with opponent/date.", "coverage": { "mode": "historical", "scope": "completed_tournament_archive", "reason": "A fixture selector is required: pass event_urn, provider_event_id, event (e.g. \"Brazil vs Morocco\"), or team with opponent/date.", "status": "unavailable", "reason_code": "fixture_selector_required", "eligible_count": null, "excluded_count": null, "included_count": null, "schema_version": "worldcup-storefront-coverage-v1", "accepted_fields": [ "event_urn", "provider_event_id", "event", "team", "opponent", "date", "home_team", "away_team" ], "population_count": null, "exclusion_reasons": {}, "source_provenance": [], "unsupported_fields": [] }, "reason_code": "fixture_selector_required", "accepted_fields": [ "event_urn", "provider_event_id", "event", "team", "opponent", "date", "home_team", "away_team" ] }, "status": "error" }, "summary": "Real body captured through the ZeroClick storefront (agents.machina.gg) on 2026-09-22: empty body" }, "selector_ambiguous": { "value": { "data": {}, "meta": { "code": 400 }, "error": { "code": 400, "type": "selector_ambiguous", "billed": false, "archive": { "live": false, "mode": "final_archive", "notes": [ "Fixture input is ambiguous; add opponent/date or use one candidate event_urn." ], "status": "unavailable", "version": "world-cup-2026-final-v3", "provenance": [], "competition": "FIFA World Cup 2026", "reason_code": "fixture_ambiguous", "snapshot_as_of": null, "capability_status": "unavailable", "competition_status": "completed", "missing_capabilities": [] }, "message": "Fixture input is ambiguous; add opponent/date or use one candidate event_urn.", "coverage": { "mode": "historical", "scope": "completed_tournament_archive", "reason": "Fixture input is ambiguous; add opponent/date or use one candidate event_urn.", "status": "unavailable", "reason_code": "fixture_ambiguous", "eligible_count": null, "excluded_count": null, "included_count": null, "schema_version": "worldcup-storefront-coverage-v1", "accepted_fields": [ "event_urn", "provider_event_id", "event", "team", "opponent", "date", "home_team", "away_team" ], "population_count": null, "exclusion_reasons": {}, "source_provenance": [], "unsupported_fields": [] }, "candidates": [ { "name": "Brazil vs Morocco - FIFA World Cup 2026", "round": "Group Stage - 1", "score": { "away": 1, "home": 1, "elapsed": 90 }, "stage": "Group Stage - 1", "teams": [ { "name": "Brazil", "crest": "https://media.api-sports.io/football/teams/6.png", "team_urn": "urn:machina:sport:soccer:team:brazil:bra", "qualifier": "home" }, { "name": "Morocco", "crest": "https://media.api-sports.io/football/teams/31.png", "team_urn": "urn:machina:sport:soccer:team:morocco:mar", "qualifier": "away" } ], "venue": "MetLife Stadium", "status": "ft", "event_urn": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "fixture_id": "1489371", "start_date": "2026-06-13T22:00:00+00:00", "competition": "FIFA World Cup 2026" }, { "name": "Brazil vs Haiti - FIFA World Cup 2026", "round": "Group Stage - 2", "score": { "away": 0, "home": 3, "elapsed": 90 }, "stage": "Group Stage - 2", "teams": [ { "name": "Brazil", "crest": "https://media.api-sports.io/football/teams/6.png", "team_urn": "urn:machina:sport:soccer:team:brazil:bra", "qualifier": "home" }, { "name": "Haiti", "crest": "https://media.api-sports.io/football/teams/2386.png", "team_urn": "urn:machina:sport:soccer:team:haiti:hti", "qualifier": "away" } ], "venue": "Lincoln Financial Field", "status": "ft", "event_urn": "urn:machina:sport:soccer:event:brazil-vs-haiti:20260620:wor", "fixture_id": "1489389", "start_date": "2026-06-20T00:30:00+00:00", "competition": "FIFA World Cup 2026" }, { "name": "Scotland vs Brazil - FIFA World Cup 2026", "round": "Group Stage - 3", "score": { "away": 3, "home": 0, "elapsed": 90 }, "stage": "Group Stage - 3", "teams": [ { "name": "Scotland", "crest": "https://media.api-sports.io/football/teams/1108.png", "team_urn": "urn:machina:sport:soccer:team:scotland:sco", "qualifier": "home" }, { "name": "Brazil", "crest": "https://media.api-sports.io/football/teams/6.png", "team_urn": "urn:machina:sport:soccer:team:brazil:bra", "qualifier": "away" } ], "venue": "Hard Rock Stadium", "status": "ft", "event_urn": "urn:machina:sport:soccer:event:scotland-vs-brazil:20260624:wor", "fixture_id": "1489406", "start_date": "2026-06-24T22:00:00+00:00", "competition": "FIFA World Cup 2026" } ], "reason_code": "fixture_ambiguous", "accepted_fields": [ "event_urn", "provider_event_id", "event", "team", "opponent", "date", "home_team", "away_team" ] }, "status": "error" }, "summary": "Real body captured through the ZeroClick storefront (agents.machina.gg) on 2026-09-22: body {\"team\":\"Brazil\"}; candidates trimmed to 3" } } } }, "description": "The request did not identify what to answer about (coverage.reason_code = fixture_selector_required / fixture_ambiguous / player_selector_required / player_ambiguous / entity_selector_required / entity_ambiguous) or used a parameter variant outside the archive catalog (unsupported_parameter). `candidates` lists the fixtures/players that matched when the selector was ambiguous. Never billed." }, "402": { "description": "Payment required" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref15" }, "examples": { "not_found": { "value": { "data": {}, "meta": { "code": 404 }, "error": { "code": 404, "type": "not_found", "billed": false, "archive": { "live": false, "mode": "final_archive", "notes": [ "No archived FIFA World Cup 2026 fixture matched the supplied selector." ], "status": "unavailable", "version": "world-cup-2026-final-v3", "provenance": [], "competition": "FIFA World Cup 2026", "reason_code": "fixture_not_found", "snapshot_as_of": null, "capability_status": "unavailable", "competition_status": "completed", "missing_capabilities": [] }, "message": "No archived FIFA World Cup 2026 fixture matched the supplied selector.", "coverage": { "mode": "historical", "scope": "completed_tournament_archive", "reason": "No archived FIFA World Cup 2026 fixture matched the supplied selector.", "status": "unavailable", "reason_code": "fixture_not_found", "eligible_count": null, "excluded_count": null, "included_count": null, "schema_version": "worldcup-storefront-coverage-v1", "accepted_fields": [ "event_urn", "provider_event_id", "event", "team", "opponent", "date", "home_team", "away_team" ], "population_count": null, "exclusion_reasons": {}, "source_provenance": [], "unsupported_fields": [] }, "reason_code": "fixture_not_found", "accepted_fields": [ "event_urn", "provider_event_id", "event", "team", "opponent", "date", "home_team", "away_team" ] }, "status": "error" }, "summary": "Real body captured through the ZeroClick storefront (agents.machina.gg) on 2026-09-22: body {\"event\":\"Brazil vs Narnia\"}" } } } }, "description": "The selector resolved to no archived fixture / player / entity (coverage.reason_code = *_not_found). Never billed." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref15" } } }, "description": "Archive integrity error (coverage.reason_code = archive_error); nothing was served. Never billed." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref15" } } }, "description": "A valid selector for which the archive holds no row (coverage.reason_code = archive_row_missing). Retry later. Never billed." } }, "description": "Joins persisted World Cup 2026 player identities to both fixture teams. This is an archived tournament identity snapshot, not proof of complete FIFA squad registration.", "requestBody": { "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a3f45504ac796802_ref0" }, { "type": "object", "required": [ "home_team", "away_team" ], "properties": { "away_team": { "type": "string" }, "home_team": { "type": "string" } } } ] }, "examples": { "fixture": { "value": { "event": "Brazil vs Morocco" } }, "captured": { "value": { "event": "Brazil vs Morocco" }, "summary": "Request used for the captured 200 example" }, "teamPair": { "value": { "away_team": "Morocco", "home_team": "Brazil" } } } } }, "required": true }, "x-zeroclick-document-sources": [ { "gaps": [], "pages": [], "sourceId": "sds_kS_Na0vlgH8jHcvZiy8eD", "authority": "official", "conflicts": [], "revisionId": "sdrn_IB5cI6fYy5LIS4OREpc2m" }, { "gaps": [ "Missing request body schema", "Missing parameter definitions" ], "pages": [ 1 ], "sourceId": "sds_lEILwU1VMqWXAvmNynqZQ", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description", "/description" ], "revisionId": "sdrn_-CuYe8y_ET60tB1VhI3Sl" }, { "gaps": [ "Missing request body schema", "Missing parameters" ], "pages": [ 1 ], "sourceId": "sds_pYBubIfmVitksSAV5O4y8", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description" ], "revisionId": "sdrn_18lH1kSa6dItqVVxgexAA" } ], "x-zeroclick-services": [ "match-context" ], "x-payment-info": { "access": "payg", "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "10000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.010000 per call (squads, service match-context)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "rates": [ { "service": "match-context", "meter": "squads", "unit": "call", "unitSize": 1, "priceUsd": "0.010000", "includedUnits": 0 } ], "perCallUsage": [ { "service": "match-context", "meter": "squads", "quantity": 1 } ] } } }, "/world-cup/v1/get-standings": { "post": { "summary": "Final tournament standings", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "data", "meta" ], "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref1" }, { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref5" } ] }, "meta": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref0" } ], "properties": { "code": { "const": 200 } } }, "status": { "const": "success" } }, "description": "Transport envelope as delivered by api.machina.gg and the ZeroClick storefront; `data` carries the endpoint payload." }, "examples": { "archived": { "value": { "data": { "archive": { "live": false, "mode": "final_archive", "notes": [ "Final group tables; no stored source timestamp is available." ], "status": "hit", "version": "world-cup-2026-final-v3", "provenance": [ "api-football" ], "competition": "FIFA World Cup 2026", "snapshot_as_of": "2026-09-13T12:43:17.191390Z", "response_sha256": "0b4f12550c52895d600605736678cc666d3b51c46e02fc99479f989236b73cb8", "capability_status": "complete", "competition_status": "completed", "content_created_at": null, "source_observed_at": "2026-09-13T12:43:17.191390Z", "timestamp_semantics": "source_capture_observation", "missing_capabilities": [], "source_manifest_sha256": "8f3eefa03f995001e1d653212c8a6df8dfa2c731052296161bbeaa6c07f3729c", "request_identity_sha256": "55c97e348e84695e761804824ea22de65964a87079d09f13823b803024a60e81" }, "coverage": { "mode": "historical", "scope": "completed_tournament_archive", "reason": "Twelve final group tables are separate from the 12-team third-place ranking; no 1-to-48 ranking is inferred.", "status": "complete", "eligible_count": 48, "excluded_count": 0, "included_count": 48, "schema_version": "worldcup-storefront-coverage-v1", "population_count": 48, "exclusion_reasons": {}, "source_provenance": [ "api-football" ], "unsupported_fields": [ "final_1_to_48_tournament_ranking" ] }, "warnings": [], "standings": { "groups": [ { "group": "Group A", "table": [ { "win": 3, "draw": 0, "lose": 0, "rank": 1, "team": "Mexico", "crest": "https://media.api-sports.io/football/teams/16.png", "played": 3, "points": 9, "team_id": 16, "goal_diff": 6, "goals_for": 6, "goals_against": 0 }, { "win": 1, "draw": 1, "lose": 1, "rank": 2, "team": "South Africa", "crest": "https://media.api-sports.io/football/teams/1531.png", "played": 3, "points": 4, "team_id": 1531, "goal_diff": -1, "goals_for": 2, "goals_against": 3 }, { "win": 1, "draw": 0, "lose": 2, "rank": 3, "team": "South Korea", "crest": "https://media.api-sports.io/football/teams/17.png", "played": 3, "points": 3, "team_id": 17, "goal_diff": -1, "goals_for": 2, "goals_against": 3 } ] }, { "group": "Group B", "table": [ { "win": 2, "draw": 1, "lose": 0, "rank": 1, "team": "Switzerland", "crest": "https://media.api-sports.io/football/teams/15.png", "played": 3, "points": 7, "team_id": 15, "goal_diff": 4, "goals_for": 7, "goals_against": 3 }, { "win": 1, "draw": 1, "lose": 1, "rank": 2, "team": "Canada", "crest": "https://media.api-sports.io/football/teams/5529.png", "played": 3, "points": 4, "team_id": 5529, "goal_diff": 5, "goals_for": 8, "goals_against": 3 }, { "win": 1, "draw": 1, "lose": 1, "rank": 3, "team": "Bosnia & Herzegovina", "crest": "https://media.api-sports.io/football/teams/1113.png", "played": 3, "points": 4, "team_id": 1113, "goal_diff": -1, "goals_for": 5, "goals_against": 6 } ] }, { "group": "Group C", "table": [ { "win": 2, "draw": 1, "lose": 0, "rank": 1, "team": "Brazil", "crest": "https://media.api-sports.io/football/teams/6.png", "played": 3, "points": 7, "team_id": 6, "goal_diff": 6, "goals_for": 7, "goals_against": 1 }, { "win": 2, "draw": 1, "lose": 0, "rank": 2, "team": "Morocco", "crest": "https://media.api-sports.io/football/teams/31.png", "played": 3, "points": 7, "team_id": 31, "goal_diff": 3, "goals_for": 6, "goals_against": 3 }, { "win": 1, "draw": 0, "lose": 2, "rank": 3, "team": "Scotland", "crest": "https://media.api-sports.io/football/teams/1108.png", "played": 3, "points": 3, "team_id": 1108, "goal_diff": -3, "goals_for": 1, "goals_against": 4 } ] } ], "season": "2026", "source": "api-football", "warnings": [], "league_id": "1", "team_count": 48, "group_count": 12, "standings_scope": "final_group_standings", "third_place_ranking": [ { "win": 1, "draw": 1, "lose": 1, "rank": 1, "team": "Congo DR", "crest": "https://media.api-sports.io/football/teams/1508.png", "played": 3, "points": 4, "team_id": 1508, "goal_diff": 1, "goals_for": 4, "goals_against": 3 }, { "win": 1, "draw": 1, "lose": 1, "rank": 2, "team": "Sweden", "crest": "https://media.api-sports.io/football/teams/5.png", "played": 3, "points": 4, "team_id": 5, "goal_diff": 0, "goals_for": 7, "goals_against": 7 }, { "win": 1, "draw": 1, "lose": 1, "rank": 3, "team": "Ghana", "crest": "https://media.api-sports.io/football/teams/1504.png", "played": 3, "points": 4, "team_id": 1504, "goal_diff": 0, "goals_for": 2, "goals_against": 2 } ], "is_final_1_to_48_ranking": false } }, "meta": { "code": 200 }, "status": "success" }, "summary": "Real 200 body captured from the production archive on 2026-09-18 (arrays trimmed to 3 items) — wrapped in the transport envelope {status, meta, data}" } } } }, "description": "Final group tables and third-place ranking when available." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref10" }, "examples": { "unsupported_parameter": { "value": { "data": {}, "meta": { "code": 400 }, "error": { "code": 400, "type": "unsupported_parameter", "billed": false, "archive": { "live": false, "mode": "final_archive", "notes": [ "League or season is outside the World Cup 2026 v3 archive catalog; no fallback execution is allowed." ], "status": "unavailable", "version": "world-cup-2026-final-v3", "provenance": [], "competition": "FIFA World Cup 2026", "reason_code": "unsupported_parameter", "snapshot_as_of": null, "capability_status": "unavailable", "competition_status": "completed", "missing_capabilities": [] }, "message": "League or season is outside the World Cup 2026 v3 archive catalog; no fallback execution is allowed.", "coverage": { "mode": "historical", "scope": "completed_tournament_archive", "reason": "League or season is outside the World Cup 2026 v3 archive catalog; no fallback execution is allowed.", "status": "unavailable", "reason_code": "unsupported_parameter", "eligible_count": null, "excluded_count": null, "included_count": null, "schema_version": "worldcup-storefront-coverage-v1", "accepted_fields": [ "league", "season", "event_urn", "provider_event_id" ], "population_count": null, "exclusion_reasons": {}, "source_provenance": [], "unsupported_fields": [] }, "reason_code": "unsupported_parameter", "accepted_fields": [ "league", "season", "event_urn", "provider_event_id" ] }, "status": "error" }, "summary": "Real body captured through the ZeroClick storefront (agents.machina.gg) on 2026-09-22: body {\"league\":\"39\",\"season\":\"2026\"}" } } } }, "description": "The request did not identify what to answer about (coverage.reason_code = fixture_selector_required / fixture_ambiguous / player_selector_required / player_ambiguous / entity_selector_required / entity_ambiguous) or used a parameter variant outside the archive catalog (unsupported_parameter). `candidates` lists the fixtures/players that matched when the selector was ambiguous. Never billed." }, "402": { "description": "Payment required" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref10" } } }, "description": "The selector resolved to no archived fixture / player / entity (coverage.reason_code = *_not_found). Never billed." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref10" } } }, "description": "Archive integrity error (coverage.reason_code = archive_error); nothing was served. Never billed." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_fa799db834b53f41_ref10" } } }, "description": "A valid selector for which the archive holds no row (coverage.reason_code = archive_row_missing). Retry later. Never billed." } }, "description": "Final World Cup 2026 group tables. An empty body defaults to API-Football league 1 and season 2026.", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "league": { "type": "string", "default": "1" }, "season": { "type": "string", "default": "2026" }, "event_urn": { "type": "string" }, "provider_event_id": { "type": "string" } } }, "examples": { "captured": { "value": {}, "summary": "Request used for the captured 200 example" }, "explicit": { "value": { "league": "1", "season": "2026" } }, "defaultTournament": { "value": {} } } } }, "required": false }, "x-zeroclick-document-sources": [ { "gaps": [], "pages": [], "sourceId": "sds_kS_Na0vlgH8jHcvZiy8eD", "authority": "official", "conflicts": [], "revisionId": "sdrn_IB5cI6fYy5LIS4OREpc2m" }, { "gaps": [ "Missing request body schema", "Missing parameter definitions" ], "pages": [ 1 ], "sourceId": "sds_lEILwU1VMqWXAvmNynqZQ", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description", "/description" ], "revisionId": "sdrn_-CuYe8y_ET60tB1VhI3Sl" }, { "gaps": [ "Missing request body schema", "Missing parameters" ], "pages": [ 1 ], "sourceId": "sds_pYBubIfmVitksSAV5O4y8", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description" ], "revisionId": "sdrn_18lH1kSa6dItqVVxgexAA" } ], "x-zeroclick-services": [ "match-context" ], "x-payment-info": { "access": "payg", "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "10000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.010000 per call (standings, service match-context)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "rates": [ { "service": "match-context", "meter": "standings", "unit": "call", "unitSize": 1, "priceUsd": "0.010000", "includedUnits": 0 } ], "perCallUsage": [ { "service": "match-context", "meter": "standings", "quantity": 1 } ] } } }, "/world-cup/v1/resolve": { "post": { "summary": "Resolve a provider id to a canonical entity", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "data", "meta" ], "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref1" }, { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref8" } ] }, "meta": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref0" } ], "properties": { "code": { "const": 200 } } }, "status": { "const": "success" } }, "description": "Transport envelope as delivered by api.machina.gg and the ZeroClick storefront; `data` carries the endpoint payload." }, "examples": { "archived": { "value": { "data": { "count": 1, "entity": { "id": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "@id": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "_id": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "name": "Brazil vs Morocco - FIFA World Cup 2026", "@type": [ "sport:Event", "schema:SportsEvent" ], "round": "Group Stage - 1", "stage": "Group Stage - 1", "@context": { "sport": "https://www.sportschema.org/ontologies/sport#", "schema": "https://schema.org/", "machina": "https://schema.machina.gg/sports#" }, "live_score": { "away": 1, "home": 1, "elapsed": 90 }, "sport:venue": { "@id": "urn:machina:sport:soccer:venue:metlife-stadium:eas", "name": "MetLife Stadium", "@type": "sport:Venue", "schema:addressLocality": "East Rutherford" }, "provider_ids": { "opta": "ar8b186wqraa80u0vpi2e4nis", "entain": "7722038", "sportradar": "sr:sport_event:66456928", "api_football": "1489371" }, "sport:status": "FT", "schema:startDate": "2026-06-13T22:00:00+00:00", "sport:competition": { "@id": "urn:machina:sport:soccer:competition:fifa-world-cup-2026:wor", "name": "FIFA World Cup 2026", "@type": "sport:Competition" }, "sport:competitors": [ { "@id": "urn:machina:sport:soccer:team:brazil:bra", "name": "Brazil", "@type": "sport:Team", "schema:logo": "https://media.api-sports.io/football/teams/6.png", "sport:qualifier": "home" }, { "@id": "urn:machina:sport:soccer:team:morocco:mar", "name": "Morocco", "@type": "sport:Team", "schema:logo": "https://media.api-sports.io/football/teams/31.png", "sport:qualifier": "away" } ], "identity_mapping_status": "canonical", "machina_competition_slug": "world-cup-2026" }, "archive": { "live": false, "mode": "final_archive", "notes": [ "Exact archived entity resolution." ], "status": "hit", "version": "world-cup-2026-final-v3", "provenance": [ "worldcup:event" ], "competition": "FIFA World Cup 2026", "snapshot_as_of": null, "response_sha256": "040487001cfd55c3ce11cf2da97f3b551a2b63c13594285a182c58742117a49c", "capability_status": "complete", "competition_status": "completed", "content_created_at": null, "source_observed_at": null, "timestamp_semantics": "unavailable", "missing_capabilities": [], "source_manifest_sha256": "856f7786586c41a5cc152b1b37158355bf21863c63a6bc1553046dec02662e68", "request_identity_sha256": "b3b3d4dc3f2f1f065cd9fe8229ff13fc5bd8c79f981856501c9bc93d3ea717f0" }, "coverage": { "mode": "historical", "scope": "completed_tournament_archive", "reason": "Exact archived canonical or provider identity resolution.", "status": "complete", "eligible_count": 1, "excluded_count": 0, "included_count": 1, "schema_version": "worldcup-storefront-coverage-v1", "population_count": 1, "exclusion_reasons": {}, "source_provenance": [ "worldcup:event" ], "unsupported_fields": [] }, "entities": [ { "id": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "@id": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "_id": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "name": "Brazil vs Morocco - FIFA World Cup 2026", "@type": [ "sport:Event", "schema:SportsEvent" ], "round": "Group Stage - 1", "stage": "Group Stage - 1", "@context": { "sport": "https://www.sportschema.org/ontologies/sport#", "schema": "https://schema.org/", "machina": "https://schema.machina.gg/sports#" }, "live_score": { "away": 1, "home": 1, "elapsed": 90 }, "sport:venue": { "@id": "urn:machina:sport:soccer:venue:metlife-stadium:eas", "name": "MetLife Stadium", "@type": "sport:Venue", "schema:addressLocality": "East Rutherford" }, "provider_ids": { "opta": "ar8b186wqraa80u0vpi2e4nis", "entain": "7722038", "sportradar": "sr:sport_event:66456928", "api_football": "1489371" }, "sport:status": "FT", "schema:startDate": "2026-06-13T22:00:00+00:00", "sport:competition": { "@id": "urn:machina:sport:soccer:competition:fifa-world-cup-2026:wor", "name": "FIFA World Cup 2026", "@type": "sport:Competition" }, "sport:competitors": [ { "@id": "urn:machina:sport:soccer:team:brazil:bra", "name": "Brazil", "@type": "sport:Team", "schema:logo": "https://media.api-sports.io/football/teams/6.png", "sport:qualifier": "home" }, { "@id": "urn:machina:sport:soccer:team:morocco:mar", "name": "Morocco", "@type": "sport:Team", "schema:logo": "https://media.api-sports.io/football/teams/31.png", "sport:qualifier": "away" } ], "machina_competition_slug": "world-cup-2026" } ], "warnings": [] }, "meta": { "code": 200 }, "status": "success" }, "summary": "Real 200 body captured from the production archive on 2026-09-18 (arrays trimmed to 3 items) — wrapped in the transport envelope {status, meta, data}" } } } }, "description": "Resolved entity and cross-provider identifiers, or an explicit not-found warning." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref13" } } }, "description": "The request did not identify what to answer about (coverage.reason_code = fixture_selector_required / fixture_ambiguous / player_selector_required / player_ambiguous / entity_selector_required / entity_ambiguous) or used a parameter variant outside the archive catalog (unsupported_parameter). `candidates` lists the fixtures/players that matched when the selector was ambiguous. Never billed." }, "402": { "description": "Payment required" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref13" } } }, "description": "The selector resolved to no archived fixture / player / entity (coverage.reason_code = *_not_found). Never billed." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref13" } } }, "description": "Archive integrity error (coverage.reason_code = archive_error); nothing was served. Never billed." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_3366f4dae511f85d_ref13" } } }, "description": "A valid selector for which the archive holds no row (coverage.reason_code = archive_row_missing). Retry later. Never billed." } }, "description": "Exact-id resolution over archived identity and event records.", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string", "examples": [ "1489371" ], "minLength": 1, "description": "Provider id or canonical Machina URN." } } }, "examples": { "captured": { "value": { "id": "1489371" }, "summary": "Request used for the captured 200 example" }, "canonicalTeam": { "value": { "id": "urn:machina:sport:soccer:team:brazil:bra" } }, "providerFixture": { "value": { "id": "1489417" } } } } }, "required": true }, "x-zeroclick-document-sources": [ { "gaps": [], "pages": [], "sourceId": "sds_kS_Na0vlgH8jHcvZiy8eD", "authority": "official", "conflicts": [], "revisionId": "sdrn_IB5cI6fYy5LIS4OREpc2m" }, { "gaps": [ "Missing request body schema", "Missing parameter definitions" ], "pages": [ 1 ], "sourceId": "sds_lEILwU1VMqWXAvmNynqZQ", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description", "/description" ], "revisionId": "sdrn_-CuYe8y_ET60tB1VhI3Sl" }, { "gaps": [ "Missing request body schema", "Missing parameters" ], "pages": [ 1 ], "sourceId": "sds_pYBubIfmVitksSAV5O4y8", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description" ], "revisionId": "sdrn_18lH1kSa6dItqVVxgexAA" } ], "x-zeroclick-services": [ "match-context" ], "x-payment-info": { "access": "payg", "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "10000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.010000 per call (resolve, service match-context)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "rates": [ { "service": "match-context", "meter": "resolve", "unit": "call", "unitSize": 1, "priceUsd": "0.010000", "includedUnits": 0 } ], "perCallUsage": [ { "service": "match-context", "meter": "resolve", "quantity": 1 } ] } } }, "/world-cup/v1/skills/match-recap": { "post": { "summary": "Match recap", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "data", "meta" ], "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref2" }, { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref10" } ] }, "meta": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref1" } ], "properties": { "code": { "const": 200 } } }, "status": { "const": "success" } }, "description": "Transport envelope as delivered by api.machina.gg and the ZeroClick storefront; `data` carries the endpoint payload." }, "examples": { "archived": { "value": { "data": { "archive": { "live": false, "mode": "final_archive", "notes": [ "Original cached matchday copy with final score verified; narrative details retain an explicit non-revalidation caveat." ], "status": "hit", "version": "world-cup-2026-final-v3", "provenance": [ "worldcup:skill-match-recap-original-copy", "worldcup:event", "worldcup:model-forecast" ], "competition": "FIFA World Cup 2026", "snapshot_as_of": "2026-08-31T23:37:57.540271Z", "response_sha256": "2e8c61cdd0816f34c69dab1065271ac234652e798616255e86e6adc3ca6cabb9", "capability_status": "evergreen_editorial", "competition_status": "completed", "content_created_at": "2026-08-31T23:37:57.540271Z", "source_observed_at": null, "timestamp_semantics": "original_editorial_generation", "missing_capabilities": [], "source_manifest_sha256": "7d6e0e267f6b3dce6077676fdadc0c7ba5a9e7b21e876795b4e889f49dfe9bd1", "request_identity_sha256": "9878f2c71e178b2918df5bacd1565fc4cf8689898c38346683437a80c8f0d961" }, "coverage": { "mode": "historical", "scope": "completed_tournament_archive", "reason": "Final result facts and archived player observations are exposed separately from unsupported narrative.", "status": "complete", "eligible_count": 51, "excluded_count": 0, "included_count": 51, "schema_version": "worldcup-storefront-coverage-v1", "population_count": 51, "exclusion_reasons": {}, "source_provenance": [ "worldcup:skill-match-recap-original-copy", "worldcup:event", "worldcup:model-forecast" ], "unsupported_fields": [ "match_awards", "quotes", "scorers" ] }, "warnings": [ "Original cached matchday copy is preserved. Claims beyond fixture identity and final score were not independently revalidated for this archive release." ], "event_urn": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "candidates": [ { "name": "Brazil vs Morocco - FIFA World Cup 2026", "round": "Group Stage - 1", "score": { "away": 1, "home": 1, "elapsed": 90 }, "stage": "Group Stage - 1", "teams": [ { "name": "Brazil", "crest": "https://media.api-sports.io/football/teams/6.png", "team_urn": "urn:machina:sport:soccer:team:brazil:bra", "qualifier": "home" }, { "name": "Morocco", "crest": "https://media.api-sports.io/football/teams/31.png", "team_urn": "urn:machina:sport:soccer:team:morocco:mar", "qualifier": "away" } ], "venue": "MetLife Stadium", "status": "ft", "event_urn": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "fixture_id": "1489371", "start_date": "2026-06-13T22:00:00+00:00", "competition": "FIFA World Cup 2026", "result_details": { "status": "FT", "winner": null, "fixture_id": "1489371", "provenance": { "provider": "api-football", "capture_id": "6aa6d8852677921cf5d5f48e", "fixture_id": "1489371", "source_url": "https://www.api-football.com/", "observed_at": "2026-09-13T17:08:22.003454Z", "capture_name": "worldcup-archive-capture-results", "capture_sha256": "10522211a9442626d08c603aa9a01c4c3afe3ae2dfc7217e0e7e2290c5e85406", "provider_result_sha256": "9fb8564dae34abe16550eee706bd060efd31c24899c005231b4ae5f7ac7d9a55" }, "schema_version": "worldcup-result-details-v1", "shootout_score": null, "regulation_time_score": { "away": 1, "home": 1 }, "extra_time_score_contribution": null } } ], "skill_card": { "sources": [ { "source": "worldcup:skill-match-recap", "subject_urn": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "generated_at": "2026-08-31T23:37:57.540271Z" }, { "source": "worldcup:event", "event_urn": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "provider_ids": { "opta": "ar8b186wqraa80u0vpi2e4nis", "entain": "7722038", "sportradar": "sr:sport_event:66456928", "api_football": "1489371" } }, { "source": "worldcup:model-forecast", "event_urn": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "model_computed_at": "2026-06-13T07:00:02.352497Z" } ], "summary": "Brazil and Morocco played out an intense 1-1 draw in their opening match of the 2026 FIFA World Cup at MetLife Stadium. Morocco opened the scoring in the 21st minute when Ismael Saibari intercepted a loose ball and lobbed Alisson Becker. Brazil responded just 11 minutes later through a spectacular individual effort from Vinícius Júnior. Despite late pressure and a dramatic double save by Alisson in the 98th minute, neither side could find a winner, leaving both teams with a point in Group C.", "headline": "Brazil and Morocco Share the Points in Hard-Fought 1-1 World Cup Draw", "event_urn": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "grounding": { "claims_scope": "original_cached_copy_with_unverified_narrative", "event_sha256": "72d3746a9927e8b4ed606a64d6b69341cf7168b6ac67c2efdd22fff2397fe1ab", "forecast_sha256": "635d5ad6d3a36990629f0e8e9ad86b7d09b98aeeac893817a5d7092bb4798067", "final_score_verified": true, "narrative_details_revalidated": false }, "disclaimer": "Informational sports market intelligence only. Not betting, trading, financial, or investment advice.", "final_score": "1-1", "content_depth": { "tier": "result_and_observed_player_evidence", "unsupported_narrative": [ "scorers", "turning_points", "quotes" ], "narrative_verification": "unverified_original", "observed_player_records": [ { "name": "Achraf Hakimi Mouh", "team": "Morocco", "player_id": "9", "player_key": "urn:machina:sport:soccer:player:achraf-hakimi-mouh:19981104:mar", "player_urn": "urn:machina:sport:soccer:player:achraf-hakimi-mouh:19981104:mar", "statistics": { "name": "Achraf Hakimi", "team_id": "31", "position": "D", "player_id": "9", "team_name": "Morocco", "is_goalkeeper": false, "minutes_played": 90, "minutes_evidence": true, "eligible_for_power_ranking": true } }, { "name": "Ahmed Reda Tagnaouti", "team": "Morocco", "player_id": "2703", "player_key": "urn:machina:sport:soccer:player:ahmed-reda-tagnaouti:19960405:mar", "player_urn": "urn:machina:sport:soccer:player:ahmed-reda-tagnaouti:19960405:mar", "statistics": { "name": "Ahmed Reda Tagnaouti", "team_id": "31", "position": "G", "player_id": "2703", "team_name": "Morocco", "is_goalkeeper": true, "minutes_played": null, "minutes_evidence": false, "eligible_for_power_ranking": null } }, { "name": "Alex Sandro", "team": "Brazil", "player_id": "860", "player_key": "urn:machina:sport:soccer:player:alex-sandro:19910126:bra", "player_urn": "urn:machina:sport:soccer:player:alex-sandro:19910126:bra", "statistics": { "name": "Alex Sandro", "team_id": "6", "position": "D", "player_id": "860", "team_name": "Brazil", "is_goalkeeper": false, "minutes_played": null, "minutes_evidence": false, "eligible_for_power_ranking": null } } ] }, "what_it_means": "The draw leaves both teams with one point in Group C, demonstrating Morocco's ability to compete with elite opposition and serving as an early wake-up call for Brazil.", "result_details": { "status": "FT", "winner": null, "fixture_id": "1489371", "provenance": { "provider": "api-football", "capture_id": "6aa6d8852677921cf5d5f48e", "fixture_id": "1489371", "source_url": "https://www.api-football.com/", "observed_at": "2026-09-13T17:08:22.003454Z", "capture_name": "worldcup-archive-capture-results", "capture_sha256": "10522211a9442626d08c603aa9a01c4c3afe3ae2dfc7217e0e7e2290c5e85406", "provider_result_sha256": "9fb8564dae34abe16550eee706bd060efd31c24899c005231b4ae5f7ac7d9a55" }, "schema_version": "worldcup-result-details-v1", "shootout_score": null, "regulation_time_score": { "away": 1, "home": 1 }, "extra_time_score_contribution": null }, "turning_points": [ "21st minute: Ismael Saibari capitalizes on a midfield error, lobbing Alisson Becker to put Morocco ahead.", "32nd minute: Vinícius Júnior cuts inside and curls a brilliant shot into the top corner to level the score for Brazil.", "90+8th minute: Alisson Becker produces a crucial double save to deny Morocco a dramatic late winner." ], "archive_caveats": [ "Original cached matchday copy is preserved. Claims beyond fixture identity and final score were not independently revalidated for this archive release." ], "standout_players": [ "Ismael Saibari (Morocco) - Scored the opening goal with a clever lob and remained a constant threat.", "Vinícius Júnior (Brazil) - Provided the moment of magic needed to equalize for his side.", "Alisson Becker (Brazil) - Secured the draw with vital late-game heroics in stoppage time." ], "forecast_scorecard": { "hit": false, "note": "Although the model favored a Brazil victory overall (38.69% probability), it successfully identified 1-1 as the single most likely exact scoreline with a 14.95% probability.", "actual_outcome": "Draw", "predicted_score": "1-1", "predicted_outcome": "Brazil Win" }, "historical_perspective": "original_cached_matchday_copy" }, "served_from": "final_archive", "resolved_fixture": { "name": "Brazil vs Morocco - FIFA World Cup 2026", "round": "Group Stage - 1", "score": { "away": 1, "home": 1, "elapsed": 90 }, "stage": "Group Stage - 1", "teams": [ { "name": "Brazil", "crest": "https://media.api-sports.io/football/teams/6.png", "team_urn": "urn:machina:sport:soccer:team:brazil:bra", "qualifier": "home" }, { "name": "Morocco", "crest": "https://media.api-sports.io/football/teams/31.png", "team_urn": "urn:machina:sport:soccer:team:morocco:mar", "qualifier": "away" } ], "venue": "MetLife Stadium", "status": "ft", "event_urn": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "fixture_id": "1489371", "start_date": "2026-06-13T22:00:00+00:00", "competition": "FIFA World Cup 2026", "result_details": { "status": "FT", "winner": null, "fixture_id": "1489371", "provenance": { "provider": "api-football", "capture_id": "6aa6d8852677921cf5d5f48e", "fixture_id": "1489371", "source_url": "https://www.api-football.com/", "observed_at": "2026-09-13T17:08:22.003454Z", "capture_name": "worldcup-archive-capture-results", "capture_sha256": "10522211a9442626d08c603aa9a01c4c3afe3ae2dfc7217e0e7e2290c5e85406", "provider_result_sha256": "9fb8564dae34abe16550eee706bd060efd31c24899c005231b4ae5f7ac7d9a55" }, "schema_version": "worldcup-result-details-v1", "shootout_score": null, "regulation_time_score": { "away": 1, "home": 1 }, "extra_time_score_contribution": null } } }, "meta": { "code": 200 }, "status": "success" }, "summary": "Real 200 body captured from the production archive on 2026-09-18 (arrays trimmed to 3 items) — wrapped in the transport envelope {status, meta, data}" } } } }, "description": "Source-annotated archived recap or explicit archive miss." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref11" } } }, "description": "The request did not identify what to answer about (coverage.reason_code = fixture_selector_required / fixture_ambiguous / player_selector_required / player_ambiguous / entity_selector_required / entity_ambiguous) or used a parameter variant outside the archive catalog (unsupported_parameter). `candidates` lists the fixtures/players that matched when the selector was ambiguous. Never billed." }, "402": { "description": "Payment required" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref11" } } }, "description": "The selector resolved to no archived fixture / player / entity (coverage.reason_code = *_not_found). Never billed." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref11" } } }, "description": "Archive integrity error (coverage.reason_code = archive_error); nothing was served. Never billed." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref11" } } }, "description": "A valid selector for which the archive holds no row (coverage.reason_code = archive_row_missing). Retry later. Never billed." } }, "description": "Returns original archived copy with its generation date, historical-perspective annotation, and event references when warmed. A clean miss retains legacy behavior during canary migration; force_regen cannot bypass a valid archive hit.", "requestBody": { "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_5ccefe5b179e8d8d_ref0" }, { "type": "object", "properties": { "force_regen": { "type": "boolean", "default": false, "deprecated": true, "description": "Ignored by archive serving." } } } ] }, "examples": { "archived": { "value": { "event": "Brazil vs Morocco" } }, "captured": { "value": { "event": "Brazil vs Morocco" }, "summary": "Request used for the captured 200 example" } } } }, "required": true }, "x-zeroclick-document-sources": [ { "gaps": [], "pages": [], "sourceId": "sds_kS_Na0vlgH8jHcvZiy8eD", "authority": "official", "conflicts": [], "revisionId": "sdrn_IB5cI6fYy5LIS4OREpc2m" }, { "gaps": [ "Missing request body schema", "Missing parameter definitions" ], "pages": [ 1 ], "sourceId": "sds_lEILwU1VMqWXAvmNynqZQ", "authority": "supplemental", "conflicts": [ "/responses/200/description", "/description" ], "revisionId": "sdrn_-CuYe8y_ET60tB1VhI3Sl" }, { "gaps": [ "Missing request body schema", "Missing parameters" ], "pages": [ 1 ], "sourceId": "sds_pYBubIfmVitksSAV5O4y8", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description" ], "revisionId": "sdrn_18lH1kSa6dItqVVxgexAA" } ], "x-zeroclick-services": [ "finished-content" ], "x-payment-info": { "access": "payg", "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "400000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.400000 per call (match_recap, service finished-content)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.400000" }, "rates": [ { "service": "finished-content", "meter": "match_recap", "unit": "call", "unitSize": 1, "priceUsd": "0.400000", "includedUnits": 0 } ], "perCallUsage": [ { "service": "finished-content", "meter": "match_recap", "quantity": 1 } ] } } }, "/world-cup/v1/skills/player-spotlight": { "post": { "summary": "Player spotlight", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "data", "meta" ], "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref1" }, { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref8" } ] }, "meta": { "allOf": [ { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref0" } ], "properties": { "code": { "const": 200 } } }, "status": { "const": "success" } }, "description": "Transport envelope as delivered by api.machina.gg and the ZeroClick storefront; `data` carries the endpoint payload." }, "examples": { "archived": { "value": { "data": { "archive": { "live": false, "mode": "final_archive", "notes": [ "Structured retrospective is derived only from verified archived fixture player observations." ], "status": "hit", "version": "world-cup-2026-final-v3", "provenance": [ "worldcup:skill-player-spotlight", "worldcup:storefront-derived-player-card", "worldcup:identity-reconciliation" ], "competition": "FIFA World Cup 2026", "snapshot_as_of": "2026-09-01T02:08:38.840067Z", "response_sha256": "d07910c9b576120690393998f9cd8302b6faa6fa19e45b5b5db77456fa61298c", "capability_status": "archived_editorial", "competition_status": "completed", "content_created_at": "2026-09-01T02:08:38.840067Z", "source_observed_at": null, "timestamp_semantics": "original_editorial_generation", "missing_capabilities": [], "source_manifest_sha256": "799ecb6fc8dd00c1e2975b9d2dcc3c16f214113764c14e78a84db8eab2f5c529", "request_identity_sha256": "1cff56d461fe890546cd2921a29a2c638eee5e57c507d0a5bef0cdd8d838ff46" }, "coverage": { "mode": "historical", "scope": "completed_tournament_archive", "reason": "Observed tournament appearances are available; unsupported biography and narrative fields are explicit.", "status": "complete", "eligible_count": 5, "excluded_count": 0, "included_count": 5, "schema_version": "worldcup-storefront-coverage-v1", "population_count": 5, "exclusion_reasons": {}, "source_provenance": [ "worldcup:skill-player-spotlight", "worldcup:storefront-derived-player-card", "worldcup:identity-reconciliation" ], "unsupported_fields": [ "biography", "impact_narrative", "match_awards" ] }, "warnings": [], "candidates": [ { "name": "Vinícius Júnior", "team": "Brazil", "player_key": "urn:machina:sport:soccer:player:vinicius:20000712:bra", "player_urn": "urn:machina:sport:soccer:player:vinicius:20000712:bra", "provider_ids": { "espn": "252107", "api_football": "762" } } ], "player_key": "urn:machina:sport:soccer:player:vinicius:20000712:bra", "player_urn": "urn:machina:sport:soccer:player:vinicius:20000712:bra", "skill_card": { "team": "Brazil", "headline": "FIFA World Cup 2026 Tournament Spotlight: Vinícius Júnior", "position": "Forward", "narrative": "Vinícius Júnior is officially registered in the Brazil squad as a Forward for the FIFA World Cup 2026. Born on July 12, 2000, his squad identity is confirmed for the tournament.", "disclaimer": "This spotlight is based solely on the official FIFA World Cup 2026 tournament squad records. No external club statistics, transfer rumors, or post-tournament events are included.", "player_name": "Vinícius Júnior" }, "served_from": "final_archive", "content_type": "original_editorial_with_structured_retrospective", "player_overview": { "name": "Vinícius Júnior", "team": "Brazil", "player_key": "urn:machina:sport:soccer:player:vinicius:20000712:bra", "player_urn": "urn:machina:sport:soccer:player:vinicius:20000712:bra", "provider_ids": { "espn": "252107", "api_football": "762" }, "provider_id_aliases": {}, "official_registration": { "source": "FIFA", "status": "verified_final_published_snapshot", "club_raw": "Real Madrid C. F. (ESP)", "warnings": [], "height_cm": 176, "team_name": "Brazil", "birth_date": "2000-07-12", "scope_note": "Caps/goals are FIFA-reported international totals, not World Cup match statistics.", "source_url": "https://fdp.fifa.org/assetspublic/ce281/pdf/SquadLists-English.pdf", "source_page": 7, "published_at": "2026-07-19T22:34:35+00:00", "jersey_number": 7, "position_code": "FW", "source_sha256": "02a0a9beb5d219e7cc0aedde19273e9a3bfe4818ecd600d37804b8801dd96d94", "fifa_team_code": "BRA", "last_names_raw": "PAIXÃO DE OLIVEIRA JÚNIOR", "shirt_name_raw": "VINI JR.", "first_names_raw": "Vinicius José", "player_name_raw": "VINICIUS JUNIOR", "canonical_birth_date": "2000-07-12", "canonical_birth_date_conflict": false, "international_caps_as_reported": 54, "international_goals_as_reported": 13 }, "identity_mapping_status": "official_reconciled" }, "resolved_player": { "_id": "urn:machina:sport:soccer:player:vinicius:20000712:bra", "name": "Vinícius Júnior", "team": { "@id": "urn:machina:sport:soccer:team:brazil:bra", "name": "Brazil" }, "aliases": [], "team_id": "6", "team_name": "Brazil", "nationality": "Brazil", "provider_ids": { "espn": "252107", "api_football": "762" }, "provider_id_aliases": {}, "observed_provider_ids": [ "762" ], "official_registration": { "source": "FIFA", "status": "verified_final_published_snapshot", "club_raw": "Real Madrid C. F. (ESP)", "warnings": [], "height_cm": 176, "team_name": "Brazil", "birth_date": "2000-07-12", "scope_note": "Caps/goals are FIFA-reported international totals, not World Cup match statistics.", "source_url": "https://fdp.fifa.org/assetspublic/ce281/pdf/SquadLists-English.pdf", "source_page": 7, "published_at": "2026-07-19T22:34:35+00:00", "jersey_number": 7, "position_code": "FW", "source_sha256": "02a0a9beb5d219e7cc0aedde19273e9a3bfe4818ecd600d37804b8801dd96d94", "fifa_team_code": "BRA", "last_names_raw": "PAIXÃO DE OLIVEIRA JÚNIOR", "shirt_name_raw": "VINI JR.", "first_names_raw": "Vinicius José", "player_name_raw": "VINICIUS JUNIOR", "canonical_birth_date": "2000-07-12", "canonical_birth_date_conflict": false, "international_caps_as_reported": 54, "international_goals_as_reported": 13 }, "identity_mapping_status": "official_reconciled" }, "original_editorial": { "body": { "team": "Brazil", "headline": "FIFA World Cup 2026 Tournament Spotlight: Vinícius Júnior", "position": "Forward", "narrative": "Vinícius Júnior is officially registered in the Brazil squad as a Forward for the FIFA World Cup 2026. Born on July 12, 2000, his squad identity is confirmed for the tournament.", "disclaimer": "This spotlight is based solely on the official FIFA World Cup 2026 tournament squad records. No external club statistics, transfer rumors, or post-tournament events are included.", "player_name": "Vinícius Júnior" }, "generated_at": "2026-09-01T02:08:38.840067Z" }, "structured_retrospective": { "name": "Vinícius Júnior", "team": "Brazil", "grounding": { "source": "reconciled_raw_fixture_player_captures_and_official_fifa_registration", "unsupported_claims_included": false }, "player_key": "urn:machina:sport:soccer:player:vinicius:20000712:bra", "player_urn": "urn:machina:sport:soccer:player:vinicius:20000712:bra", "content_type": "structured_retrospective", "observations": [ { "team": "Brazil", "opponent": "Haiti", "event_urn": "urn:machina:sport:soccer:event:brazil-vs-haiti:20260620:wor", "fixture_id": "1489389", "statistics": { "name": "Vinícius Júnior", "team_id": "6", "position": "F", "player_id": "762", "team_name": "Brazil", "is_goalkeeper": false, "minutes_played": 81, "minutes_evidence": true, "eligible_for_power_ranking": true }, "provider_player_id": "762", "official_fifa_power_ranking": { "scores": { "attacking": 6.992136478424072, "defending": 4.667199611663818, "creativity": 6.836964130401611, "in_possession": null, "defending_goal": null }, "source": "fifa.com", "status": "available", "player_type": "outfield", "classification": { "match_rank": null, "tournament_rank": null, "category_rankings": [ { "rank": 7, "score": 6.992136478424072, "category": "attacking", "rank_change": 0, "rank_within_team": 1 }, { "rank": 16, "score": 6.836964130401611, "category": "creativity", "rank_change": -1, "rank_within_team": 1 }, { "rank": 262, "score": 4.667199611663818, "category": "defending", "rank_change": 11, "rank_within_team": 10 } ] }, "source_snapshot": { "url": "https://fdh-api.fifa.com/v1/powerranking/season/285023.json", "counts": { "goalkeepers": 28, "outfield_players": 202, "published_players": 230 }, "sha256": "5192eeb55a3b9a957f1f3951a0c757b00da608a3bcb10a13641627fb14dc0735", "nMatches": 104, "fetched_at": "2026-09-01T04:33:26.737126Z", "competitionId": 285023, "messageTimeUtc": "2026-07-20T00:28:49.92294Z", "competitionStage": "Final" }, "expected_available_at": null } }, { "team": "Brazil", "opponent": "Japan", "event_urn": "urn:machina:sport:soccer:event:brazil-vs-japan:20260629:wor", "fixture_id": "1562344", "statistics": { "name": "Vinícius Júnior", "team_id": "6", "position": "F", "player_id": "762", "team_name": "Brazil", "is_goalkeeper": false, "minutes_played": 90, "minutes_evidence": true, "eligible_for_power_ranking": true }, "provider_player_id": "762", "official_fifa_power_ranking": { "scores": { "attacking": 6.992136478424072, "defending": 4.667199611663818, "creativity": 6.836964130401611, "in_possession": null, "defending_goal": null }, "source": "fifa.com", "status": "available", "player_type": "outfield", "classification": { "match_rank": null, "tournament_rank": null, "category_rankings": [ { "rank": 7, "score": 6.992136478424072, "category": "attacking", "rank_change": 0, "rank_within_team": 1 }, { "rank": 16, "score": 6.836964130401611, "category": "creativity", "rank_change": -1, "rank_within_team": 1 }, { "rank": 262, "score": 4.667199611663818, "category": "defending", "rank_change": 11, "rank_within_team": 10 } ] }, "source_snapshot": { "url": "https://fdh-api.fifa.com/v1/powerranking/season/285023.json", "counts": { "goalkeepers": 28, "outfield_players": 202, "published_players": 230 }, "sha256": "5192eeb55a3b9a957f1f3951a0c757b00da608a3bcb10a13641627fb14dc0735", "nMatches": 104, "fetched_at": "2026-09-01T04:33:26.737126Z", "competitionId": 285023, "messageTimeUtc": "2026-07-20T00:28:49.92294Z", "competitionStage": "Final" }, "expected_available_at": null } }, { "team": "Brazil", "opponent": "Morocco", "event_urn": "urn:machina:sport:soccer:event:brazil-vs-morocco:20260613:wor", "fixture_id": "1489371", "statistics": { "name": "Vinícius Júnior", "team_id": "6", "position": "M", "player_id": "762", "team_name": "Brazil", "is_goalkeeper": false, "minutes_played": 90, "minutes_evidence": true, "eligible_for_power_ranking": true }, "provider_player_id": "762", "official_fifa_power_ranking": { "scores": { "attacking": 6.992136478424072, "defending": 4.667199611663818, "creativity": 6.836964130401611, "in_possession": null, "defending_goal": null }, "source": "fifa.com", "status": "available", "player_type": "outfield", "classification": { "match_rank": null, "tournament_rank": null, "category_rankings": [ { "rank": 7, "score": 6.992136478424072, "category": "attacking", "rank_change": 0, "rank_within_team": 1 }, { "rank": 16, "score": 6.836964130401611, "category": "creativity", "rank_change": -1, "rank_within_team": 1 }, { "rank": 262, "score": 4.667199611663818, "category": "defending", "rank_change": 11, "rank_within_team": 10 } ] }, "source_snapshot": { "url": "https://fdh-api.fifa.com/v1/powerranking/season/285023.json", "counts": { "goalkeepers": 28, "outfield_players": 202, "published_players": 230 }, "sha256": "5192eeb55a3b9a957f1f3951a0c757b00da608a3bcb10a13641627fb14dc0735", "nMatches": 104, "fetched_at": "2026-09-01T04:33:26.737126Z", "competitionId": 285023, "messageTimeUtc": "2026-07-20T00:28:49.92294Z", "competitionStage": "Final" }, "expected_available_at": null } } ], "provider_ids": { "espn": "252107", "api_football": "762" }, "observed_opponents": [ "Haiti", "Japan", "Morocco" ], "unsupported_fields": [ "biography", "transfers", "match_awards" ], "provider_id_aliases": {}, "official_registration": { "source": "FIFA", "status": "verified_final_published_snapshot", "club_raw": "Real Madrid C. F. (ESP)", "warnings": [], "height_cm": 176, "team_name": "Brazil", "birth_date": "2000-07-12", "scope_note": "Caps/goals are FIFA-reported international totals, not World Cup match statistics.", "source_url": "https://fdp.fifa.org/assetspublic/ce281/pdf/SquadLists-English.pdf", "source_page": 7, "published_at": "2026-07-19T22:34:35+00:00", "jersey_number": 7, "position_code": "FW", "source_sha256": "02a0a9beb5d219e7cc0aedde19273e9a3bfe4818ecd600d37804b8801dd96d94", "fifa_team_code": "BRA", "last_names_raw": "PAIXÃO DE OLIVEIRA JÚNIOR", "shirt_name_raw": "VINI JR.", "first_names_raw": "Vinicius José", "player_name_raw": "VINICIUS JUNIOR", "canonical_birth_date": "2000-07-12", "canonical_birth_date_conflict": false, "international_caps_as_reported": 54, "international_goals_as_reported": 13 }, "historical_perspective": "retrospective_completed_tournament", "identity_mapping_status": "official_reconciled", "observed_appearance_count": 5 } }, "meta": { "code": 200 }, "status": "success" }, "summary": "Real 200 body captured from the production archive on 2026-09-18 (arrays trimmed to 3 items) — wrapped in the transport envelope {status, meta, data}" } } } }, "description": "Archived original editorial where available plus a source-grounded structured retrospective for every observed provider player." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref13" } } }, "description": "The request did not identify what to answer about (coverage.reason_code = fixture_selector_required / fixture_ambiguous / player_selector_required / player_ambiguous / entity_selector_required / entity_ambiguous) or used a parameter variant outside the archive catalog (unsupported_parameter). `candidates` lists the fixtures/players that matched when the selector was ambiguous. Never billed." }, "402": { "description": "Payment required" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref13" } } }, "description": "The selector resolved to no archived fixture / player / entity (coverage.reason_code = *_not_found). Never billed." }, "502": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref13" } } }, "description": "Archive integrity error (coverage.reason_code = archive_error); nothing was served. Never billed." }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sds_kS_Na0vlgH8jHcvZiy8eD_a6b92ca94aab06bd_ref13" } } }, "description": "A valid selector for which the archive holds no row (coverage.reason_code = archive_row_missing). Retry later. Never billed." } }, "description": "Source-grounded structured tournament retrospective for every observed provider player. The two original editorial cards are retained separately. Exact provider ids work when no canonical URN is evidenced; force_regen cannot bypass an archive hit.", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "anyOf": [ { "required": [ "player_urn" ] }, { "required": [ "player_id" ] }, { "required": [ "player" ] } ], "properties": { "team": { "type": "string" }, "player": { "type": "string" }, "team_id": { "type": "string" }, "player_id": { "type": "string", "description": "Exact API-Football player id, including provider-only archived identities." }, "player_urn": { "type": "string" }, "force_regen": { "type": "boolean", "default": false, "deprecated": true, "description": "Ignored by archive serving." } } }, "examples": { "captured": { "value": { "team": "Brazil", "player": "Vinicius Junior" }, "summary": "Request used for the captured 200 example" }, "namedPlayer": { "value": { "team": "Brazil", "player": "Vinicius Junior" } }, "providerOnlyPlayer": { "value": { "team_id": "1548", "player_id": "575283" } } } } }, "required": true }, "x-zeroclick-document-sources": [ { "gaps": [], "pages": [], "sourceId": "sds_kS_Na0vlgH8jHcvZiy8eD", "authority": "official", "conflicts": [], "revisionId": "sdrn_IB5cI6fYy5LIS4OREpc2m" }, { "gaps": [ "Missing request body schema", "Missing parameter definitions" ], "pages": [ 1 ], "sourceId": "sds_lEILwU1VMqWXAvmNynqZQ", "authority": "supplemental", "conflicts": [ "/responses/200/description", "/description" ], "revisionId": "sdrn_-CuYe8y_ET60tB1VhI3Sl" }, { "gaps": [ "Missing request body schema", "Missing parameters" ], "pages": [ 1 ], "sourceId": "sds_pYBubIfmVitksSAV5O4y8", "authority": "supplemental", "conflicts": [ "/summary", "/responses/200/description" ], "revisionId": "sdrn_18lH1kSa6dItqVVxgexAA" } ], "x-zeroclick-services": [ "finished-content" ], "x-payment-info": { "access": "payg", "protocols": [ { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } }, { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } } ], "offers": [ { "amount": "400000", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "description": "$0.400000 per call (player_spotlight, service finished-content)", "intent": "charge", "method": "tempo" } ], "price": { "mode": "fixed", "currency": "USD", "amount": "0.400000" }, "rates": [ { "service": "finished-content", "meter": "player_spotlight", "unit": "call", "unitSize": 1, "priceUsd": "0.400000", "includedUnits": 0 } ], "perCallUsage": [ { "service": "finished-content", "meter": "player_spotlight", "quantity": 1 } ] } } }, "/zeroclick/agent/quote": { "post": { "operationId": "sellerAgentQuote", "summary": "Get a free seller API quote and purchase guide", "description": "Describe your task to get the matching API contract, prices, prerequisites and next steps. This is a $0 wallet-proof lookup, not the seller's paid service. No purchase is executed. Without a wallet, use /zeroclick/agent/guide.", "servers": [ { "url": "https://agents.machina.gg/zcj/ibypm0cxs2w4" } ], "security": [ { "sellerAgentX402": [] }, { "sellerAgentMpp": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "goal": { "type": "string", "minLength": 1, "maxLength": 2000, "description": "Describe the task and known inputs. Do not include credentials." }, "quantity": { "description": "Number of API calls, not returned items. Omit when unknown; describe desired output in goal.", "type": "integer", "minimum": 1, "maximum": 1000000 }, "budgetUsd": { "description": "Total cash budget in USD. A quote does not authorize spending.", "type": "string", "pattern": "^(0|[1-9]\\d{0,8})(\\.\\d{1,6})?$" }, "budgetExclusive": { "type": "boolean" }, "reviewAfterCalls": { "type": "integer", "minimum": 1, "maximum": 1000000 }, "requirements": { "type": "string", "minLength": 1, "maxLength": 300 }, "humanAvailable": { "description": "Whether a human is in the loop. False recommends anonymous auth for a new autonomous identity; omit when unknown. Executing a human's request without further interruptions does not by itself mean false.", "type": "boolean" }, "payment": { "description": "Known payment method for the eventual purchase, independent of this free lookup's wallet proof.", "type": "string", "enum": [ "x402", "mpp", "card" ] } }, "required": [ "goal" ], "additionalProperties": false }, "example": { "goal": "Find the available services, prices and purchase steps" } } } }, "responses": { "200": { "description": "Task guidance; inspect status before executing anything", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "status": { "type": "string", "enum": [ "quoted", "ready", "needs_input", "blocked", "unknown", "unsupported", "unavailable" ] }, "priceUsd": { "type": "string", "const": "0" }, "guide": { "type": "string", "description": "Markdown guidance containing the task result, exact contract, pricing and next steps when available. No purchase is executed." }, "guideUrl": { "type": "string", "format": "uri", "description": "Wallet-free advisor endpoint for further planning or recovery." } }, "required": [ "status", "priceUsd", "guide", "guideUrl" ], "additionalProperties": false } } } }, "402": { "description": "$0 x402 or MPP wallet proof required; sign and retry the same request. No funds are transferred." }, "503": { "description": "Advisor unavailable; use the wallet-free guide or direct storefront references" } }, "x-payment-info": { "access": "payg", "price": { "mode": "fixed", "currency": "USD", "amount": "0" }, "protocols": [ { "x402": { "network": "eip155:8453", "scheme": "exact", "currency": "USDC" } }, { "mpp": { "method": "tempo", "intent": "charge", "currency": "USD" } } ], "offers": [ { "amount": "0", "currency": "0x20C000000000000000000000b9537d11c60E8b50", "method": "tempo", "intent": "charge", "description": "Free seller advisor lookup" } ] } } } }, "x-zeroclick-navigation-footer": { "instructions": [ "Use this spec if it contains the operation and details you need. Otherwise, search or open a relevant service spec using the links below.", "Find service slugs in x-zeroclick-services or x-payment-info.rates[].service; use them in serviceSpecTemplate, never as request values.", "URL-encode template values. Search is ranked; service, path, and method filters are exact. Filters combine.", "Pages contain up to 10 operations; follow info.x-next or the Link header if you need more results. Shared operations retain all selector values." ], "fullSpec": "https://agents.machina.gg/zcj/ibypm0cxs2w4/openapi.json", "services": "https://agents.machina.gg/zcj/ibypm0cxs2w4/services", "serviceSpecTemplate": "https://agents.machina.gg/zcj/ibypm0cxs2w4/services/{slug}/openapi.json", "searchTemplate": "https://agents.machina.gg/zcj/ibypm0cxs2w4/openapi.json?q={text}", "operationTemplate": "https://agents.machina.gg/zcj/ibypm0cxs2w4/openapi.json?path={path}&method={method}", "firstPage": "https://agents.machina.gg/zcj/ibypm0cxs2w4/openapi.json?page=1" } }