{"uid":"cap_9hYFmgtlepzjqDnUOGr_q","slug":"agents-machina-gg-tournament-fixtures-5758d449","name":"Tournament Fixtures","description":"Tournament fixtures, filterable by team, opponent, and date range.","url":"https://agents.machina.gg/world-cup/v1/get-schedule?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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"}}},"responseSchema":{"type":"object","required":["status","data","meta"],"properties":{"data":{"anyOf":[{"allOf":[{"type":"object","required":["archive","coverage","warnings"],"properties":{"archive":{"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}$"}}},"coverage":{"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"}}}},"warnings":{"type":"array","items":{"type":"string"}}}},{"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":{"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"}}}},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"string"}},"truncated":{"type":"boolean"},"total_count":{"type":"integer"}}}}}]},{"allOf":[{"type":"object","required":["archive","coverage","warnings"],"properties":{"archive":{"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}$"}}},"coverage":{"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"}}}},"warnings":{"type":"array","items":{"type":"string"}}}},{"type":"object","properties":{"candidates":{"type":"array","items":{"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"}}}}}}]}]},"meta":{"allOf":[{"type":"object","required":["code"],"properties":{"code":{"type":"integer","description":"Mirrors the HTTP status code."}},"description":"Platform-owned envelope metadata."}],"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."},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":2,"rating":{"score":"1.00","successRate":"1.00","reviews":2,"stars":"5.0","state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"1.0000","medianCents":"1.0000","p90Cents":"1.0000","minCents":"1.0000","maxCents":"1.0000","p95Cents":"1.0000","sampleCount":5,"varies":false,"failureChargeRate":null},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7rV9Hupg5Ko7j6SloubhD","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_xzSpWpTZly6IEOEyyr77p","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.machina.gg","brandSlug":"agents-machina-gg-x402","brandBaseUrl":"https://agents.machina.gg","brandDocsUrl":null,"whatItDoes":"Retrieves World Cup 2026 tournament fixture schedules, filterable by team name, opponent, and date range, returning canonical event URNs.","exampleAgentPrompt":"Can you pull up Brazil's World Cup 2026 fixtures, especially any matches they have between June 14 and June 30? I want to see when they play and get the match IDs.","exampleUseCases":[{"title":"Fan tracking team's full schedule","prompt":"Show me all of France's World Cup 2026 matches — I want to see every game they have and the dates so I can plan which ones to watch."},{"title":"Finding a specific head-to-head fixture","prompt":"When do Argentina and Mexico play each other at the 2026 World Cup? I need the date and the match ID for that game."},{"title":"Monitoring upcoming matches in a date window","prompt":"What World Cup fixtures are happening between June 20 and June 25, 2026? Show me all the games scheduled in that window."}],"resultDescription":"Returns a list of tournament fixtures matching the filters, each containing match details (teams, date, venue) and a canonical event_urn that can be used as input to other Machina World Cup endpoints such as match forecasts, recaps, and enriched match context.","failureModes":["Unknown or misspelled team name returns empty fixture list or error","Date range with no matches returns empty array","Invalid date format (not YYYY-MM-DD) causes validation error","Opponent filter with no matching head-to-head fixture returns empty result","Request for teams not participating in the 2026 World Cup returns no results","Payment failure ($0.01 not fulfilled) results in 402 response"],"whenToPreferThis":"Use this endpoint when you need to discover World Cup 2026 match schedules and obtain canonical event_urn identifiers needed to call other Machina endpoints (forecasts, recaps, enriched context, player performance). It is the discovery primitive for all fixture-scoped operations. Prefer this over general sports APIs when you need Machina's canonical entity resolution or when chaining into the rest of the Machina World Cup intelligence suite.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":67,"lastUsedAt":"2026-10-20T07:28:07.858Z","lastSuccessfullyRanAt":"2026-10-20T07:28:07.858Z","lastHealthCheckAt":"2026-10-31T12:36:17.855Z","isFirstParty":false,"canonicalSlug":"agents-machina-gg-tournament-fixtures-5758d449"}