Machina Sports · Schema

SquadsResponse

SportsArtificial IntelligencePlatformSports AIDevelopers

Properties

Name Type Description
archive object
coverage object
warnings array
squads object
candidates array
View JSON Schema on GitHub

JSON Schema

machina-gg-squads-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/machina-gg/json-schema/machina-gg-squads-response-schema.json",
  "title": "SquadsResponse",
  "x-generated": "2026-11-17",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/machina-gg-openapi.json#/components/schemas/SquadsResponse",
  "allOf": [
    {
      "$ref": "#/$defs/ResponseBase"
    },
    {
      "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",
              "minItems": 2,
              "items": {
                "type": "object",
                "required": [
                  "side"
                ]
              }
            },
            "evidence_status": {
              "enum": [
                "observed_tournament_player_pool",
                "unavailable"
              ]
            },
            "official_registration_status": {
              "const": "verified_final_published_snapshot"
            },
            "observed_player_count": {
              "type": "integer",
              "minimum": 0
            },
            "official_registration_snapshot": {
              "$ref": "#/$defs/OfficialRegistrationSnapshot"
            }
          }
        },
        "candidates": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/FixtureSummary"
          }
        }
      }
    }
  ],
  "$defs": {
    "ArchiveMetadata": {
      "type": "object",
      "required": [
        "mode",
        "version",
        "status",
        "competition",
        "competition_status",
        "live",
        "snapshot_as_of",
        "capability_status",
        "provenance",
        "missing_capabilities",
        "notes"
      ],
      "properties": {
        "mode": {
          "const": "final_archive"
        },
        "version": {
          "type": "string",
          "enum": [
            "world-cup-2026-final-v2",
            "world-cup-2026-final-v3"
          ]
        },
        "status": {
          "type": "string",
          "enum": [
            "hit",
            "miss",
            "unavailable",
            "error"
          ],
          "description": "hit = an immutable archived row was served. unavailable/error = nothing was served; see coverage.reason_code. A `miss` never reaches the public surface."
        },
        "competition": {
          "const": "FIFA World Cup 2026"
        },
        "competition_status": {
          "const": "completed"
        },
        "live": {
          "const": false
        },
        "snapshot_as_of": {
          "type": [
            "string",
            "null"
          ]
        },
        "source_observed_at": {
          "type": [
            "string",
            "null"
          ]
        },
        "content_created_at": {
          "type": [
            "string",
            "null"
          ]
        },
        "timestamp_semantics": {
          "type": "string"
        },
        "capability_status": {
          "type": "string"
        },
        "provenance": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "missing_capabilities": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "notes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "response_sha256": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$"
        },
        "source_manifest_sha256": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$"
        },
        "request_identity_sha256": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$"
        },
        "reason_code": {
          "type": "string",
          "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"
          ]
        }
      }
    },
    "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": {
        "schema_version": {
          "const": "worldcup-storefront-coverage-v1"
        },
        "status": {
          "type": "string",
          "enum": [
            "complete",
            "partial",
            "unavailable",
            "error"
          ]
        },
        "reason": {
          "type": "string",
          "minLength": 1
        },
        "scope": {
          "const": "completed_tournament_archive"
        },
        "mode": {
          "const": "historical"
        },
        "source_provenance": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "population_count": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0,
          "description": "Null means the legacy response did not record this count; null is never equivalent to zero."
        },
        "eligible_count": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0
        },
        "included_count": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0
        },
        "excluded_count": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0
        },
        "exclusion_reasons": {
          "type": "object",
          "additionalProperties": {
            "type": "integer",
            "minimum": 0
          }
        },
        "unsupported_fields": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "reason_code": {
          "type": "string",
          "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"
          ],
          "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."
        },
        "accepted_fields": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "The request fields this endpoint accepts, echoed on unserved responses so an agent can self-correct."
        }
      }
    },
    "FixtureSummary": {
      "type": "object",
      "required": [
        "event_urn",
        "name",
        "start_date",
        "status",
        "teams",
        "fixture_id"
      ],
      "properties": {
        "event_urn": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "start_date": {
          "type": "string"
        },
        "status": {
          "type": "string"
        },
        "competition": {
          "type": "string"
        },
        "score": {
          "$ref": "#/$defs/Score"
        },
        "round": {
          "type": [
            "string",
            "null"
          ]
        },
        "stage": {
          "type": [
            "string",
            "null"
          ]
        },
        "teams": {
          "type": "array",
          "minItems": 2,
          "items": {
            "$ref": "#/$defs/TeamSummary"
          }
        },
        "venue": {
          "type": [
            "string",
            "null"
          ]
        },
        "fixture_id": {
          "type": [
            "string",
            "integer"
          ]
        },
        "result_details": {
          "$ref": "#/$defs/ResultDetails"
        }
      }
    },
    "OfficialRegistrationSnapshot": {
      "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"
        },
        "published_at": {
          "type": "string",
          "format": "date-time"
        },
        "source_url": {
          "type": "string",
          "format": "uri"
        },
        "source_sha256": {
          "type": "string",
          "pattern": "^[0-9a-f]{64}$"
        },
        "snapshot_team_count": {
          "const": 48
        },
        "players_per_team": {
          "const": 26
        },
        "teams": {
          "type": "array",
          "minItems": 2,
          "maxItems": 2,
          "items": {
            "$ref": "#/$defs/OfficialRegistrationTeam"
          }
        },
        "completeness": {
          "type": "object"
        },
        "limitations": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "OfficialRegistrationTeam": {
      "type": "object",
      "required": [
        "team_name",
        "fifa_team_code",
        "source_page",
        "player_count",
        "players",
        "source",
        "completeness"
      ],
      "properties": {
        "team_name": {
          "type": "string"
        },
        "fifa_team_code": {
          "type": "string"
        },
        "source_page": {
          "type": "integer",
          "minimum": 1,
          "maximum": 48
        },
        "player_count": {
          "const": 26
        },
        "players": {
          "type": "array",
          "minItems": 26,
          "maxItems": 26,
          "items": {
            "$ref": "#/$defs/OfficialRosterPlayer"
          }
        },
        "source": {
          "type": "object",
          "required": [
            "publisher",
            "url",
            "sha256",
            "published_at",
            "page"
          ]
        },
        "completeness": {
          "type": "object",
          "required": [
            "status",
            "expected_players",
            "included_players"
          ]
        }
      }
    },
    "OfficialRosterPlayer": {
      "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": {
        "canonical_urn": {
          "type": "string"
        },
        "provider_ids": {
          "$ref": "#/$defs/ProviderIds"
        },
        "provider_id_aliases": {
          "type": "object",
          "additionalProperties": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "identity_mapping_status": {
          "const": "official_reconciled"
        },
        "team_name": {
          "type": "string"
        },
        "fifa_team_code": {
          "type": "string"
        },
        "jersey_number": {
          "type": "integer",
          "minimum": 1,
          "maximum": 26
        },
        "player_name_raw": {
          "type": "string"
        },
        "first_names_raw": {
          "type": "string"
        },
        "last_names_raw": {
          "type": "string"
        },
        "shirt_name_raw": {
          "type": "string"
        },
        "birth_date": {
          "type": "string",
          "format": "date"
        },
        "position_code": {
          "enum": [
            "GK",
            "DF",
            "MF",
            "FW"
          ]
        },
        "club_raw": {
          "type": [
            "string",
            "null"
          ]
        },
        "height_cm": {
          "type": "integer"
        },
        "international_caps_as_reported": {
          "type": "integer"
        },
        "international_goals_as_reported": {
          "type": "integer"
        },
        "source_page": {
          "type": "integer",
          "minimum": 1,
          "maximum": 48
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "canonical_birth_date": {
          "type": [
            "string",
            "null"
          ]
        },
        "canonical_birth_date_conflict": {
          "type": "boolean"
        }
      }
    },
    "ProviderIds": {
      "type": "object",
      "additionalProperties": {
        "type": [
          "string",
          "integer",
          "null"
        ]
      }
    },
    "ResponseBase": {
      "type": "object",
      "required": [
        "archive",
        "coverage",
        "warnings"
      ],
      "properties": {
        "archive": {
          "$ref": "#/$defs/ArchiveMetadata"
        },
        "coverage": {
          "$ref": "#/$defs/Coverage"
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "ResultDetails": {
      "type": "object",
      "required": [
        "schema_version",
        "fixture_id",
        "status",
        "regulation_time_score",
        "extra_time_score_contribution",
        "shootout_score",
        "winner",
        "provenance"
      ],
      "properties": {
        "schema_version": {
          "const": "worldcup-result-details-v1"
        },
        "fixture_id": {
          "type": "string"
        },
        "status": {
          "type": "string",
          "enum": [
            "FT",
            "AET",
            "PEN"
          ]
        },
        "regulation_time_score": {
          "$ref": "#/$defs/Score"
        },
        "extra_time_score_contribution": {
          "$ref": "#/$defs/Score"
        },
        "shootout_score": {
          "$ref": "#/$defs/Score"
        },
        "winner": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "qualifier": {
              "type": "string"
            },
            "team_id": {
              "type": "string"
            },
            "name": {
              "type": "string"
            }
          }
        },
        "provenance": {
          "type": "object",
          "required": [
            "provider",
            "fixture_id",
            "provider_result_sha256",
            "source_url",
            "observed_at"
          ],
          "properties": {
            "provider": {
              "type": "string"
            },
            "fixture_id": {
              "type": "string"
            },
            "provider_result_sha256": {
              "type": "string",
              "pattern": "^[0-9a-f]{64}$"
            },
            "source_url": {
              "type": "string",
              "format": "uri"
            },
            "observed_at": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        }
      }
    },
    "Score": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "home": {
          "type": "integer",
          "minimum": 0
        },
        "away": {
          "type": "integer",
          "minimum": 0
        },
        "elapsed": {
          "type": "number",
          "minimum": 0
        }
      }
    },
    "TeamSummary": {
      "type": "object",
      "required": [
        "name"
      ],
      "properties": {
        "team_urn": {
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "type": "string"
        },
        "qualifier": {
          "type": "string"
        },
        "crest": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/machina-gg-squads-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.