{"uid":"cap_C1becj6jNzWsSvP-5uOjc","slug":"agents-machina-gg-machina-world-cup-entity-resolver-0bbc96bb","name":"Machina World Cup Entity Resolver","description":"Resolves a provider id (api_football, sportradar, opta, entain, espn) or canonical machina URN to the entity it identifies, with all cross-provider ids attached.","url":"https://agents.machina.gg/world-cup/v1/resolve?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"id":{"type":"string","examples":["1489371"],"minLength":1,"description":"Provider id or canonical Machina URN."}}},"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":["entity","entities","count"],"properties":{"count":{"type":"integer","minimum":0},"entity":{"type":"object","properties":{"@id":{"type":["string","null"]},"_id":{"type":["string","null"]},"name":{"type":"string"},"player_key":{"type":"string"},"provider_ids":{"type":"object","additionalProperties":{"type":["string","integer","null"]}},"provider_id_aliases":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}},"official_registration":{"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"}}},"identity_mapping_status":{"enum":["canonical","official_reconciled","provider_only","quarantined"],"type":"string"}}},"entities":{"type":"array","items":{"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"}}}}}}]},{"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_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"}}}}}}]}]},"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":1,"rating":{"score":"1.00","successRate":"0.89","reviews":1,"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_S3ENcs1JWVi2ajtsDUjBl","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_IF56yMdmlg2EaP1cemw9s","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":"Resolves a provider-specific sports ID (api_football, sportradar, opta, entain, espn) or canonical Machina URN to the unified entity it identifies, returning all cross-provider IDs attached.","exampleAgentPrompt":"Can you resolve the sportradar ID 'sr:competitor:4748' to its canonical Machina entity and show me all the cross-provider IDs attached to it?","exampleUseCases":[{"title":"Cross-provider team ID mapping","prompt":"I have a sportradar competitor ID 'sr:competitor:4748' for a World Cup team — can you resolve it to the canonical Machina entity and show me its ESPN and api_football IDs too?"},{"title":"Canonical URN lookup for editorial pipeline","prompt":"I need the canonical Machina URN for Brazil's national team — I have their api_football ID '1489417', can you resolve it and get me all the cross-provider identifiers?"},{"title":"Entity deduplication for betting data","prompt":"We're merging match data from Entain and Opta and keep hitting entity mismatches — can you resolve this entain ID to the canonical Machina entity so I can confirm it's the same team?"}],"resultDescription":"A canonical entity object containing the resolved entity (team, player, or competition), its canonical Machina URN, and all known cross-provider IDs (api_football, sportradar, opta, entain, espn) attached to that entity.","failureModes":["Unknown or invalid provider ID — entity not found, returns error","Ambiguous ID that maps to multiple entities — may return error or require more context","Unsupported provider not in the accepted list — validation error","Malformed URN format — returns schema validation error","Network timeout or upstream API failure — returns 5xx error"],"whenToPreferThis":"Use this endpoint when you have a sports entity ID from any major provider (sportradar, api_football, opta, entain, espn) or a Machina URN and need to resolve it to a canonical entity with all cross-provider identifiers. Ideal for deduplicating entities across data sources, enriching match or player data pipelines, or bootstrapping entity identity before calling other Machina World Cup endpoints that require canonical URNs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":9,"lastUsedAt":"2026-10-20T07:28:13.595Z","lastSuccessfullyRanAt":"2026-10-20T07:28:13.595Z","lastHealthCheckAt":"2026-10-31T12:30:37.548Z","isFirstParty":false,"canonicalSlug":"agents-machina-gg-machina-world-cup-entity-resolver-0bbc96bb"}