{ "openapi": "3.1.0", "info": { "title": "Lacrosse API", "version": "2.0.0", "description": "REST and WebSocket data for PLL/WLL fixtures, live scores, play-by-play, box scores, season statistics, standings, transactions, and verified multi-book market data. Authenticate with Authorization: Bearer lax_live_… Every response envelope carries `request_id`; source freshness and completeness metadata is present when meaningful for the resource." }, "externalDocs": { "description": "Human-readable documentation and compatibility policy", "url": "https://lacrosse-api.com/docs" }, "servers": [ { "url": "https://lacrosse-api.com/v1" } ], "paths": { "/competitions": { "get": { "summary": "List competitions", "responses": { "200": { "description": "Competitions" } }, "security": [ { "ApiKey": [] } ] } }, "/competitions/{id}": { "get": { "summary": "Get competition", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Competition" }, "404": { "description": "Not found" } }, "security": [ { "ApiKey": [] } ] } }, "/seasons": { "get": { "summary": "List seasons", "parameters": [ { "name": "competition_id", "in": "query", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Seasons" } }, "security": [ { "ApiKey": [] } ] } }, "/events": { "get": { "summary": "List events", "parameters": [ { "name": "season_id", "in": "query", "schema": { "type": "string", "format": "uuid" } }, { "name": "active_only", "in": "query", "schema": { "type": "boolean" } }, { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 100, "maximum": 200 } } ], "responses": { "200": { "description": "Events" } }, "security": [ { "ApiKey": [] } ] } }, "/events/{id}": { "get": { "summary": "Get event", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Event", "content": { "application/json": { "schema": { "$ref": "#/definitions/EventEnvelope", "definitions": { "EventEnvelope": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "season_id": { "type": [ "string", "null" ] }, "venue_id": { "$ref": "#/definitions/EventEnvelope/properties/data/properties/season_id" }, "name": { "type": "string" }, "starts_on": { "$ref": "#/definitions/EventEnvelope/properties/data/properties/season_id" }, "ends_on": { "$ref": "#/definitions/EventEnvelope/properties/data/properties/season_id" }, "timezone": { "$ref": "#/definitions/EventEnvelope/properties/data/properties/season_id" }, "week": { "$ref": "#/definitions/EventEnvelope/properties/data/properties/season_id" }, "season_segment": { "$ref": "#/definitions/EventEnvelope/properties/data/properties/season_id" }, "active": { "type": "boolean" } }, "required": [ "id", "season_id", "venue_id", "name", "starts_on", "ends_on", "timezone", "week", "season_segment", "active" ], "additionalProperties": false }, "meta": { "type": "object", "properties": { "request_id": { "type": "string" }, "generated_at": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$" }, "pagination": { "type": "object", "properties": { "next_cursor": { "type": [ "string", "null" ] }, "has_more": { "type": "boolean" } }, "required": [ "next_cursor", "has_more" ], "additionalProperties": false }, "observed_at": { "anyOf": [ { "$ref": "#/definitions/EventEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "cached_at": { "anyOf": [ { "$ref": "#/definitions/EventEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "freshness_seconds": { "type": [ "number", "null" ] }, "cache_age_seconds": { "type": [ "number", "null" ] }, "completeness": { "type": "string", "enum": [ "full", "partial" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sources": { "type": "array", "items": { "type": "string" } } }, "required": [ "request_id", "generated_at" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#" } } } }, "404": { "description": "Not found" } }, "security": [ { "ApiKey": [] } ] } }, "/events/{id}/teams": { "get": { "summary": "Teams competing at an event", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Event teams", "content": { "application/json": { "schema": { "$ref": "#/definitions/EventTeamsEnvelope", "definitions": { "EventTeamsEnvelope": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "team": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "name": { "type": "string" }, "abbreviation": { "type": [ "string", "null" ] }, "location": { "$ref": "#/definitions/EventTeamsEnvelope/properties/data/items/properties/team/properties/abbreviation" }, "location_code": { "$ref": "#/definitions/EventTeamsEnvelope/properties/data/items/properties/team/properties/abbreviation" }, "conference": { "$ref": "#/definitions/EventTeamsEnvelope/properties/data/items/properties/team/properties/abbreviation" }, "logo_url": { "$ref": "#/definitions/EventTeamsEnvelope/properties/data/items/properties/team/properties/abbreviation" }, "team_color": { "$ref": "#/definitions/EventTeamsEnvelope/properties/data/items/properties/team/properties/abbreviation" }, "background_color": { "$ref": "#/definitions/EventTeamsEnvelope/properties/data/items/properties/team/properties/abbreviation" } }, "required": [ "id", "name", "abbreviation", "location", "location_code", "conference", "logo_url", "team_color", "background_color" ], "additionalProperties": false }, "seed": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "team", "seed" ], "additionalProperties": false } }, "meta": { "type": "object", "properties": { "request_id": { "type": "string" }, "generated_at": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$" }, "pagination": { "type": "object", "properties": { "next_cursor": { "type": [ "string", "null" ] }, "has_more": { "type": "boolean" } }, "required": [ "next_cursor", "has_more" ], "additionalProperties": false }, "observed_at": { "anyOf": [ { "$ref": "#/definitions/EventTeamsEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "cached_at": { "anyOf": [ { "$ref": "#/definitions/EventTeamsEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "freshness_seconds": { "type": [ "number", "null" ] }, "cache_age_seconds": { "type": [ "number", "null" ] }, "completeness": { "type": "string", "enum": [ "full", "partial" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sources": { "type": "array", "items": { "type": "string" } } }, "required": [ "request_id", "generated_at" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#" } } } }, "404": { "description": "Not found" } }, "security": [ { "ApiKey": [] } ] } }, "/events/{id}/standings/latest": { "get": { "summary": "Latest standings for an event", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Standings snapshot", "content": { "application/json": { "schema": { "$ref": "#/definitions/StandingsEnvelope", "definitions": { "StandingsEnvelope": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "event_id": { "type": [ "string", "null" ] }, "season_id": { "$ref": "#/definitions/StandingsEnvelope/properties/data/properties/event_id" }, "captured_at": { "type": "string", "minLength": 1 }, "standings": { "type": "array", "items": { "type": "object", "properties": { "team": { "type": "object", "properties": { "id": { "$ref": "#/definitions/StandingsEnvelope/properties/data/properties/id" }, "name": { "type": "string" }, "abbreviation": { "$ref": "#/definitions/StandingsEnvelope/properties/data/properties/event_id" }, "location": { "$ref": "#/definitions/StandingsEnvelope/properties/data/properties/event_id" }, "location_code": { "$ref": "#/definitions/StandingsEnvelope/properties/data/properties/event_id" }, "conference": { "$ref": "#/definitions/StandingsEnvelope/properties/data/properties/event_id" }, "logo_url": { "$ref": "#/definitions/StandingsEnvelope/properties/data/properties/event_id" }, "team_color": { "$ref": "#/definitions/StandingsEnvelope/properties/data/properties/event_id" }, "background_color": { "$ref": "#/definitions/StandingsEnvelope/properties/data/properties/event_id" } }, "required": [ "id", "name", "abbreviation", "location", "location_code", "conference", "logo_url", "team_color", "background_color" ], "additionalProperties": false }, "rank": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "wins": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "losses": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "ties": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "scores": { "type": [ "number", "null" ] }, "scores_against": { "type": [ "number", "null" ] }, "score_diff": { "type": [ "number", "null" ] }, "conference": { "$ref": "#/definitions/StandingsEnvelope/properties/data/properties/event_id" }, "conference_wins": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "conference_losses": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "conference_ties": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "seed": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "conference_seed": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "team", "rank", "wins", "losses", "ties", "scores", "scores_against", "score_diff", "conference", "conference_wins", "conference_losses", "conference_ties", "seed", "conference_seed" ], "additionalProperties": false } } }, "required": [ "id", "event_id", "season_id", "captured_at", "standings" ], "additionalProperties": false }, "meta": { "type": "object", "properties": { "request_id": { "type": "string" }, "generated_at": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$" }, "pagination": { "type": "object", "properties": { "next_cursor": { "type": [ "string", "null" ] }, "has_more": { "type": "boolean" } }, "required": [ "next_cursor", "has_more" ], "additionalProperties": false }, "observed_at": { "anyOf": [ { "$ref": "#/definitions/StandingsEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "cached_at": { "anyOf": [ { "$ref": "#/definitions/StandingsEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "freshness_seconds": { "type": [ "number", "null" ] }, "cache_age_seconds": { "type": [ "number", "null" ] }, "completeness": { "type": "string", "enum": [ "full", "partial" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sources": { "type": "array", "items": { "type": "string" } } }, "required": [ "request_id", "generated_at" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#" } } } }, "404": { "description": "Not found" } }, "security": [ { "ApiKey": [] } ] } }, "/events/{id}/standings/history": { "get": { "summary": "Standings snapshot history for an event", "description": "Newest snapshots first.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "cursor", "in": "query", "description": "RFC 3339 captured_at value from the previous page.", "schema": { "type": "string", "format": "date-time" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 50, "maximum": 200 } } ], "responses": { "200": { "description": "Standings snapshots" }, "404": { "description": "Not found" } }, "security": [ { "ApiKey": [] } ] } }, "/seasons/{id}/standings/latest": { "get": { "summary": "Latest standings for a season", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Standings snapshot" }, "404": { "description": "Not found" } }, "security": [ { "ApiKey": [] } ] } }, "/seasons/{id}/standings/history": { "get": { "summary": "Standings snapshot history for a season", "description": "Newest snapshots first.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "cursor", "in": "query", "description": "RFC 3339 captured_at value from the previous page.", "schema": { "type": "string", "format": "date-time" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 50, "maximum": 200 } } ], "responses": { "200": { "description": "Standings snapshots" }, "404": { "description": "Not found" } }, "security": [ { "ApiKey": [] } ] } }, "/venues/{id}": { "get": { "summary": "Get venue", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Venue" }, "404": { "description": "Not found" } }, "security": [ { "ApiKey": [] } ] } }, "/teams": { "get": { "summary": "List teams", "responses": { "200": { "description": "Teams" } }, "security": [ { "ApiKey": [] } ] } }, "/teams/{id}": { "get": { "summary": "Get team", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Team" }, "404": { "description": "Not found" } }, "security": [ { "ApiKey": [] } ] } }, "/teams/{id}/roster": { "get": { "summary": "Team roster for an event", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "event_id", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Roster", "content": { "application/json": { "schema": { "$ref": "#/definitions/RosterEnvelope", "definitions": { "RosterEnvelope": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "player": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "display_name": { "type": "string" }, "country_code": { "type": [ "string", "null" ] }, "first_name": { "$ref": "#/definitions/RosterEnvelope/properties/data/items/properties/player/properties/country_code" }, "last_name": { "$ref": "#/definitions/RosterEnvelope/properties/data/items/properties/player/properties/country_code" }, "jersey_number": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "position": { "$ref": "#/definitions/RosterEnvelope/properties/data/items/properties/player/properties/country_code" }, "position_name": { "$ref": "#/definitions/RosterEnvelope/properties/data/items/properties/player/properties/country_code" }, "college": { "$ref": "#/definitions/RosterEnvelope/properties/data/items/properties/player/properties/country_code" }, "hometown": { "$ref": "#/definitions/RosterEnvelope/properties/data/items/properties/player/properties/country_code" }, "experience": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "profile_url": { "$ref": "#/definitions/RosterEnvelope/properties/data/items/properties/player/properties/country_code" } }, "required": [ "id", "display_name", "country_code", "first_name", "last_name", "jersey_number", "position", "position_name", "college", "hometown", "experience", "profile_url" ], "additionalProperties": false }, "role": { "$ref": "#/definitions/RosterEnvelope/properties/data/items/properties/player/properties/country_code" }, "starts_on": { "$ref": "#/definitions/RosterEnvelope/properties/data/items/properties/player/properties/country_code" }, "ends_on": { "$ref": "#/definitions/RosterEnvelope/properties/data/items/properties/player/properties/country_code" } }, "required": [ "player", "role", "starts_on", "ends_on" ], "additionalProperties": false } }, "meta": { "type": "object", "properties": { "request_id": { "type": "string" }, "generated_at": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$" }, "pagination": { "type": "object", "properties": { "next_cursor": { "type": [ "string", "null" ] }, "has_more": { "type": "boolean" } }, "required": [ "next_cursor", "has_more" ], "additionalProperties": false }, "observed_at": { "anyOf": [ { "$ref": "#/definitions/RosterEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "cached_at": { "anyOf": [ { "$ref": "#/definitions/RosterEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "freshness_seconds": { "type": [ "number", "null" ] }, "cache_age_seconds": { "type": [ "number", "null" ] }, "completeness": { "type": "string", "enum": [ "full", "partial" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sources": { "type": "array", "items": { "type": "string" } } }, "required": [ "request_id", "generated_at" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#" } } } } }, "security": [ { "ApiKey": [] } ] } }, "/teams/{id}/fixtures": { "get": { "summary": "Recent fixtures involving a team", "description": "Up to 200 fixtures, ordered by scheduled_at descending.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Fixtures" } }, "security": [ { "ApiKey": [] } ] } }, "/teams/{id}/matches": { "get": { "summary": "Recent games involving a team", "description": "Up to 200 matches, ordered by creation time descending.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Matches" } }, "security": [ { "ApiKey": [] } ] } }, "/players": { "get": { "summary": "List players", "responses": { "200": { "description": "Players", "content": { "application/json": { "schema": { "$ref": "#/definitions/PlayersEnvelope", "definitions": { "PlayersEnvelope": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "display_name": { "type": "string" }, "country_code": { "type": [ "string", "null" ] }, "first_name": { "$ref": "#/definitions/PlayersEnvelope/properties/data/items/properties/country_code" }, "last_name": { "$ref": "#/definitions/PlayersEnvelope/properties/data/items/properties/country_code" }, "jersey_number": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "position": { "$ref": "#/definitions/PlayersEnvelope/properties/data/items/properties/country_code" }, "position_name": { "$ref": "#/definitions/PlayersEnvelope/properties/data/items/properties/country_code" }, "college": { "$ref": "#/definitions/PlayersEnvelope/properties/data/items/properties/country_code" }, "hometown": { "$ref": "#/definitions/PlayersEnvelope/properties/data/items/properties/country_code" }, "experience": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "profile_url": { "$ref": "#/definitions/PlayersEnvelope/properties/data/items/properties/country_code" } }, "required": [ "id", "display_name", "country_code", "first_name", "last_name", "jersey_number", "position", "position_name", "college", "hometown", "experience", "profile_url" ], "additionalProperties": false } }, "meta": { "type": "object", "properties": { "request_id": { "type": "string" }, "generated_at": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$" }, "pagination": { "type": "object", "properties": { "next_cursor": { "type": [ "string", "null" ] }, "has_more": { "type": "boolean" } }, "required": [ "next_cursor", "has_more" ], "additionalProperties": false }, "observed_at": { "anyOf": [ { "$ref": "#/definitions/PlayersEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "cached_at": { "anyOf": [ { "$ref": "#/definitions/PlayersEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "freshness_seconds": { "type": [ "number", "null" ] }, "cache_age_seconds": { "type": [ "number", "null" ] }, "completeness": { "type": "string", "enum": [ "full", "partial" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sources": { "type": "array", "items": { "type": "string" } } }, "required": [ "request_id", "generated_at" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#" } } } } }, "security": [ { "ApiKey": [] } ] } }, "/players/{id}": { "get": { "summary": "Get player", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Player", "content": { "application/json": { "schema": { "$ref": "#/definitions/PlayerEnvelope", "definitions": { "PlayerEnvelope": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "display_name": { "type": "string" }, "country_code": { "type": [ "string", "null" ] }, "first_name": { "$ref": "#/definitions/PlayerEnvelope/properties/data/properties/country_code" }, "last_name": { "$ref": "#/definitions/PlayerEnvelope/properties/data/properties/country_code" }, "jersey_number": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "position": { "$ref": "#/definitions/PlayerEnvelope/properties/data/properties/country_code" }, "position_name": { "$ref": "#/definitions/PlayerEnvelope/properties/data/properties/country_code" }, "college": { "$ref": "#/definitions/PlayerEnvelope/properties/data/properties/country_code" }, "hometown": { "$ref": "#/definitions/PlayerEnvelope/properties/data/properties/country_code" }, "experience": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "profile_url": { "$ref": "#/definitions/PlayerEnvelope/properties/data/properties/country_code" } }, "required": [ "id", "display_name", "country_code", "first_name", "last_name", "jersey_number", "position", "position_name", "college", "hometown", "experience", "profile_url" ], "additionalProperties": false }, "meta": { "type": "object", "properties": { "request_id": { "type": "string" }, "generated_at": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$" }, "pagination": { "type": "object", "properties": { "next_cursor": { "type": [ "string", "null" ] }, "has_more": { "type": "boolean" } }, "required": [ "next_cursor", "has_more" ], "additionalProperties": false }, "observed_at": { "anyOf": [ { "$ref": "#/definitions/PlayerEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "cached_at": { "anyOf": [ { "$ref": "#/definitions/PlayerEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "freshness_seconds": { "type": [ "number", "null" ] }, "cache_age_seconds": { "type": [ "number", "null" ] }, "completeness": { "type": "string", "enum": [ "full", "partial" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sources": { "type": "array", "items": { "type": "string" } } }, "required": [ "request_id", "generated_at" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#" } } } }, "404": { "description": "Not found" } }, "security": [ { "ApiKey": [] } ] } }, "/fixtures": { "get": { "summary": "List fixtures", "parameters": [ { "name": "event_id", "in": "query", "schema": { "type": "string", "format": "uuid" } }, { "name": "status", "in": "query", "schema": { "type": "string", "enum": [ "scheduled", "in_progress", "completed", "cancelled" ] } }, { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 100, "maximum": 500 } } ], "responses": { "200": { "description": "Fixtures" } }, "security": [ { "ApiKey": [] } ] } }, "/fixtures/{id}": { "get": { "summary": "Get fixture", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Fixture", "content": { "application/json": { "schema": { "$ref": "#/definitions/FixtureEnvelope", "definitions": { "FixtureEnvelope": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "event_id": { "type": [ "string", "null" ] }, "status": { "type": "string", "enum": [ "scheduled", "in_progress", "completed", "cancelled" ] }, "scheduled_at": { "$ref": "#/definitions/FixtureEnvelope/properties/data/properties/event_id" }, "venue": { "$ref": "#/definitions/FixtureEnvelope/properties/data/properties/event_id" }, "week": { "$ref": "#/definitions/FixtureEnvelope/properties/data/properties/event_id" }, "game_number": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "season_segment": { "$ref": "#/definitions/FixtureEnvelope/properties/data/properties/event_id" }, "broadcaster": { "type": "array", "items": { "type": "string" } }, "is_provisional": { "type": "boolean" }, "sides": { "type": "array", "items": { "type": "object", "properties": { "side": { "type": "number", "enum": [ 0, 1 ] }, "team": { "anyOf": [ { "type": "object", "properties": { "id": { "$ref": "#/definitions/FixtureEnvelope/properties/data/properties/id" }, "name": { "type": "string" }, "abbreviation": { "$ref": "#/definitions/FixtureEnvelope/properties/data/properties/event_id" }, "location": { "$ref": "#/definitions/FixtureEnvelope/properties/data/properties/event_id" }, "location_code": { "$ref": "#/definitions/FixtureEnvelope/properties/data/properties/event_id" }, "conference": { "$ref": "#/definitions/FixtureEnvelope/properties/data/properties/event_id" }, "logo_url": { "$ref": "#/definitions/FixtureEnvelope/properties/data/properties/event_id" }, "team_color": { "$ref": "#/definitions/FixtureEnvelope/properties/data/properties/event_id" }, "background_color": { "$ref": "#/definitions/FixtureEnvelope/properties/data/properties/event_id" } }, "required": [ "id", "name", "abbreviation", "location", "location_code", "conference", "logo_url", "team_color", "background_color" ], "additionalProperties": false }, { "type": "null" } ] }, "label": { "$ref": "#/definitions/FixtureEnvelope/properties/data/properties/event_id" }, "score": { "type": "integer" }, "goals": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "side", "team", "label", "score", "goals" ], "additionalProperties": false } } }, "required": [ "id", "event_id", "status", "scheduled_at", "venue", "week", "game_number", "season_segment", "broadcaster", "is_provisional", "sides" ], "additionalProperties": false }, "meta": { "type": "object", "properties": { "request_id": { "type": "string" }, "generated_at": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$" }, "pagination": { "type": "object", "properties": { "next_cursor": { "type": [ "string", "null" ] }, "has_more": { "type": "boolean" } }, "required": [ "next_cursor", "has_more" ], "additionalProperties": false }, "observed_at": { "anyOf": [ { "$ref": "#/definitions/FixtureEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "cached_at": { "anyOf": [ { "$ref": "#/definitions/FixtureEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "freshness_seconds": { "type": [ "number", "null" ] }, "cache_age_seconds": { "type": [ "number", "null" ] }, "completeness": { "type": "string", "enum": [ "full", "partial" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sources": { "type": "array", "items": { "type": "string" } } }, "required": [ "request_id", "generated_at" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#" } } } }, "404": { "description": "Not found" } }, "security": [ { "ApiKey": [] } ] } }, "/fixtures/{id}/matches": { "get": { "summary": "Matches within a fixture", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Matches" } }, "security": [ { "ApiKey": [] } ] } }, "/fixtures/{id}/live": { "get": { "summary": "Latest observation per match in the fixture", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Live entries", "content": { "application/json": { "schema": { "$ref": "#/definitions/FixtureLiveEnvelope", "definitions": { "FixtureLiveEnvelope": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "match": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "fixture_id": { "type": [ "string", "null" ] }, "category": { "$ref": "#/definitions/FixtureLiveEnvelope/properties/data/items/properties/match/properties/fixture_id" }, "status": { "type": "string", "enum": [ "scheduled", "in_progress", "completed", "cancelled" ] }, "winner_team_id": { "$ref": "#/definitions/FixtureLiveEnvelope/properties/data/items/properties/match/properties/fixture_id" }, "completed_at": { "$ref": "#/definitions/FixtureLiveEnvelope/properties/data/items/properties/match/properties/fixture_id" }, "participants": { "type": "array", "items": { "type": "object", "properties": { "side": { "type": "number", "enum": [ 0, 1 ] }, "team": { "type": "object", "properties": { "id": { "$ref": "#/definitions/FixtureLiveEnvelope/properties/data/items/properties/match/properties/id" }, "name": { "type": "string" }, "abbreviation": { "$ref": "#/definitions/FixtureLiveEnvelope/properties/data/items/properties/match/properties/fixture_id" }, "location": { "$ref": "#/definitions/FixtureLiveEnvelope/properties/data/items/properties/match/properties/fixture_id" }, "location_code": { "$ref": "#/definitions/FixtureLiveEnvelope/properties/data/items/properties/match/properties/fixture_id" }, "conference": { "$ref": "#/definitions/FixtureLiveEnvelope/properties/data/items/properties/match/properties/fixture_id" }, "logo_url": { "$ref": "#/definitions/FixtureLiveEnvelope/properties/data/items/properties/match/properties/fixture_id" }, "team_color": { "$ref": "#/definitions/FixtureLiveEnvelope/properties/data/items/properties/match/properties/fixture_id" }, "background_color": { "$ref": "#/definitions/FixtureLiveEnvelope/properties/data/items/properties/match/properties/fixture_id" } }, "required": [ "id", "name", "abbreviation", "location", "location_code", "conference", "logo_url", "team_color", "background_color" ], "additionalProperties": false } }, "required": [ "side", "team" ], "additionalProperties": false } } }, "required": [ "id", "fixture_id", "category", "status", "winner_team_id", "completed_at" ], "additionalProperties": false }, "observation": { "anyOf": [ { "type": "object", "properties": { "sequence": { "type": "integer" }, "observed_at": { "type": "string", "minLength": 1 }, "received_at": { "$ref": "#/definitions/FixtureLiveEnvelope/properties/data/items/properties/observation/anyOf/0/properties/observed_at" }, "source": { "type": "string" }, "lifecycle": { "$ref": "#/definitions/FixtureLiveEnvelope/properties/data/items/properties/match/properties/fixture_id" }, "period": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "clock_minutes": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "clock_seconds": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "side_0_points": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "side_1_points": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "side_0_goals": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "side_1_goals": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "winner_side": { "anyOf": [ { "$ref": "#/definitions/FixtureLiveEnvelope/properties/data/items/properties/match/properties/participants/items/properties/side" }, { "type": "null" } ] } }, "required": [ "sequence", "observed_at", "received_at", "source", "lifecycle", "period", "clock_minutes", "clock_seconds", "side_0_points", "side_1_points", "side_0_goals", "side_1_goals", "winner_side" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "match", "observation" ], "additionalProperties": false } }, "meta": { "type": "object", "properties": { "request_id": { "type": "string" }, "generated_at": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$" }, "pagination": { "type": "object", "properties": { "next_cursor": { "type": [ "string", "null" ] }, "has_more": { "type": "boolean" } }, "required": [ "next_cursor", "has_more" ], "additionalProperties": false }, "observed_at": { "anyOf": [ { "$ref": "#/definitions/FixtureLiveEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "cached_at": { "anyOf": [ { "$ref": "#/definitions/FixtureLiveEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "freshness_seconds": { "type": [ "number", "null" ] }, "cache_age_seconds": { "type": [ "number", "null" ] }, "completeness": { "type": "string", "enum": [ "full", "partial" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sources": { "type": "array", "items": { "type": "string" } } }, "required": [ "request_id", "generated_at" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#" } } } } }, "security": [ { "ApiKey": [] } ] } }, "/fixtures/{id}/odds": { "get": { "summary": "Verified multi-provider odds linked to a fixture", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Verified fixture odds", "content": { "application/json": { "schema": { "$ref": "#/definitions/FixtureOddsEnvelope", "definitions": { "FixtureOddsEnvelope": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "event": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "league": { "type": "string" }, "starts_at": { "type": [ "string", "null" ] }, "link_status": { "type": "string", "enum": [ "unlinked", "suggested", "verified", "rejected" ] }, "fixture_id": { "$ref": "#/definitions/FixtureOddsEnvelope/properties/data/items/properties/event/properties/starts_at" }, "home_team": { "type": "object", "properties": { "id": { "$ref": "#/definitions/FixtureOddsEnvelope/properties/data/items/properties/event/properties/starts_at" }, "name": { "$ref": "#/definitions/FixtureOddsEnvelope/properties/data/items/properties/event/properties/starts_at" } }, "required": [ "id", "name" ], "additionalProperties": false }, "away_team": { "type": "object", "properties": { "id": { "$ref": "#/definitions/FixtureOddsEnvelope/properties/data/items/properties/event/properties/starts_at" }, "name": { "$ref": "#/definitions/FixtureOddsEnvelope/properties/data/items/properties/event/properties/starts_at" } }, "required": [ "id", "name" ], "additionalProperties": false } }, "required": [ "id", "league", "starts_at", "link_status", "fixture_id", "home_team", "away_team" ], "additionalProperties": false }, "prices": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string" }, "market_id": { "$ref": "#/definitions/FixtureOddsEnvelope/properties/data/items/properties/event/properties/id" }, "market_key": { "type": "string", "enum": [ "moneyline", "spread", "total", "futures", "prop" ] }, "provider_market_label": { "$ref": "#/definitions/FixtureOddsEnvelope/properties/data/items/properties/event/properties/starts_at" }, "period": { "$ref": "#/definitions/FixtureOddsEnvelope/properties/data/items/properties/event/properties/starts_at" }, "line": { "$ref": "#/definitions/FixtureOddsEnvelope/properties/data/items/properties/event/properties/starts_at" }, "status": { "type": "string" }, "outcome": { "type": "string" }, "decimal_odds": { "$ref": "#/definitions/FixtureOddsEnvelope/properties/data/items/properties/event/properties/starts_at" }, "original_price": { "$ref": "#/definitions/FixtureOddsEnvelope/properties/data/items/properties/event/properties/starts_at" }, "original_format": { "$ref": "#/definitions/FixtureOddsEnvelope/properties/data/items/properties/event/properties/starts_at" }, "is_live": { "type": "boolean" }, "suspended": { "type": "boolean" }, "observed_at": { "$ref": "#/definitions/FixtureOddsEnvelope/properties/data/items/properties/event/properties/starts_at" } }, "required": [ "provider", "market_id", "market_key", "provider_market_label", "period", "line", "status", "outcome", "decimal_odds", "original_price", "original_format", "is_live", "suspended", "observed_at" ], "additionalProperties": false } } }, "required": [ "event", "prices" ], "additionalProperties": false } }, "meta": { "type": "object", "properties": { "request_id": { "type": "string" }, "generated_at": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$" }, "pagination": { "type": "object", "properties": { "next_cursor": { "type": [ "string", "null" ] }, "has_more": { "type": "boolean" } }, "required": [ "next_cursor", "has_more" ], "additionalProperties": false }, "observed_at": { "anyOf": [ { "$ref": "#/definitions/FixtureOddsEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "cached_at": { "anyOf": [ { "$ref": "#/definitions/FixtureOddsEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "freshness_seconds": { "type": [ "number", "null" ] }, "cache_age_seconds": { "type": [ "number", "null" ] }, "completeness": { "type": "string", "enum": [ "full", "partial" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sources": { "type": "array", "items": { "type": "string" } } }, "required": [ "request_id", "generated_at" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#" } } } }, "403": { "description": "Markets entitlement required" } }, "security": [ { "ApiKey": [] } ] } }, "/fixtures/{id}/plays": { "get": { "summary": "Chronological play-by-play for a fixture", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 100, "maximum": 500 } } ], "responses": { "200": { "description": "Plays", "content": { "application/json": { "schema": { "$ref": "#/definitions/PlaysEnvelope", "definitions": { "PlaysEnvelope": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "fixture_id": { "$ref": "#/definitions/PlaysEnvelope/properties/data/items/properties/id" }, "period": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "minutes": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "seconds": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "event_type": { "type": [ "string", "null" ] }, "description": { "$ref": "#/definitions/PlaysEnvelope/properties/data/items/properties/event_type" }, "team_id": { "$ref": "#/definitions/PlaysEnvelope/properties/data/items/properties/event_type" }, "home_score": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "visitor_score": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "id", "fixture_id", "period", "minutes", "seconds", "event_type", "description", "team_id", "home_score", "visitor_score" ], "additionalProperties": false } }, "meta": { "type": "object", "properties": { "request_id": { "type": "string" }, "generated_at": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$" }, "pagination": { "type": "object", "properties": { "next_cursor": { "type": [ "string", "null" ] }, "has_more": { "type": "boolean" } }, "required": [ "next_cursor", "has_more" ], "additionalProperties": false }, "observed_at": { "anyOf": [ { "$ref": "#/definitions/PlaysEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "cached_at": { "anyOf": [ { "$ref": "#/definitions/PlaysEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "freshness_seconds": { "type": [ "number", "null" ] }, "cache_age_seconds": { "type": [ "number", "null" ] }, "completeness": { "type": "string", "enum": [ "full", "partial" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sources": { "type": "array", "items": { "type": "string" } } }, "required": [ "request_id", "generated_at" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#" } } } } }, "security": [ { "ApiKey": [] } ] } }, "/matches/{id}": { "get": { "summary": "Get match (includes the two participating teams)", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Match", "content": { "application/json": { "schema": { "$ref": "#/definitions/MatchEnvelope", "definitions": { "MatchEnvelope": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "fixture_id": { "type": [ "string", "null" ] }, "category": { "$ref": "#/definitions/MatchEnvelope/properties/data/properties/fixture_id" }, "status": { "type": "string", "enum": [ "scheduled", "in_progress", "completed", "cancelled" ] }, "winner_team_id": { "$ref": "#/definitions/MatchEnvelope/properties/data/properties/fixture_id" }, "completed_at": { "$ref": "#/definitions/MatchEnvelope/properties/data/properties/fixture_id" }, "participants": { "type": "array", "items": { "type": "object", "properties": { "side": { "type": "number", "enum": [ 0, 1 ] }, "team": { "type": "object", "properties": { "id": { "$ref": "#/definitions/MatchEnvelope/properties/data/properties/id" }, "name": { "type": "string" }, "abbreviation": { "$ref": "#/definitions/MatchEnvelope/properties/data/properties/fixture_id" }, "location": { "$ref": "#/definitions/MatchEnvelope/properties/data/properties/fixture_id" }, "location_code": { "$ref": "#/definitions/MatchEnvelope/properties/data/properties/fixture_id" }, "conference": { "$ref": "#/definitions/MatchEnvelope/properties/data/properties/fixture_id" }, "logo_url": { "$ref": "#/definitions/MatchEnvelope/properties/data/properties/fixture_id" }, "team_color": { "$ref": "#/definitions/MatchEnvelope/properties/data/properties/fixture_id" }, "background_color": { "$ref": "#/definitions/MatchEnvelope/properties/data/properties/fixture_id" } }, "required": [ "id", "name", "abbreviation", "location", "location_code", "conference", "logo_url", "team_color", "background_color" ], "additionalProperties": false } }, "required": [ "side", "team" ], "additionalProperties": false } } }, "required": [ "id", "fixture_id", "category", "status", "winner_team_id", "completed_at" ], "additionalProperties": false }, "meta": { "type": "object", "properties": { "request_id": { "type": "string" }, "generated_at": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$" }, "pagination": { "type": "object", "properties": { "next_cursor": { "type": [ "string", "null" ] }, "has_more": { "type": "boolean" } }, "required": [ "next_cursor", "has_more" ], "additionalProperties": false }, "observed_at": { "anyOf": [ { "$ref": "#/definitions/MatchEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "cached_at": { "anyOf": [ { "$ref": "#/definitions/MatchEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "freshness_seconds": { "type": [ "number", "null" ] }, "cache_age_seconds": { "type": [ "number", "null" ] }, "completeness": { "type": "string", "enum": [ "full", "partial" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sources": { "type": "array", "items": { "type": "string" } } }, "required": [ "request_id", "generated_at" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#" } } } }, "404": { "description": "Not found" } }, "security": [ { "ApiKey": [] } ] } }, "/matches/{id}/participants": { "get": { "summary": "Participating teams and sides", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Participants", "content": { "application/json": { "schema": { "$ref": "#/definitions/MatchParticipantsEnvelope", "definitions": { "MatchParticipantsEnvelope": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "side": { "type": "number", "enum": [ 0, 1 ] }, "team": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "name": { "type": "string" }, "abbreviation": { "type": [ "string", "null" ] }, "location": { "$ref": "#/definitions/MatchParticipantsEnvelope/properties/data/items/properties/team/properties/abbreviation" }, "location_code": { "$ref": "#/definitions/MatchParticipantsEnvelope/properties/data/items/properties/team/properties/abbreviation" }, "conference": { "$ref": "#/definitions/MatchParticipantsEnvelope/properties/data/items/properties/team/properties/abbreviation" }, "logo_url": { "$ref": "#/definitions/MatchParticipantsEnvelope/properties/data/items/properties/team/properties/abbreviation" }, "team_color": { "$ref": "#/definitions/MatchParticipantsEnvelope/properties/data/items/properties/team/properties/abbreviation" }, "background_color": { "$ref": "#/definitions/MatchParticipantsEnvelope/properties/data/items/properties/team/properties/abbreviation" } }, "required": [ "id", "name", "abbreviation", "location", "location_code", "conference", "logo_url", "team_color", "background_color" ], "additionalProperties": false } }, "required": [ "side", "team" ], "additionalProperties": false } }, "meta": { "type": "object", "properties": { "request_id": { "type": "string" }, "generated_at": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$" }, "pagination": { "type": "object", "properties": { "next_cursor": { "type": [ "string", "null" ] }, "has_more": { "type": "boolean" } }, "required": [ "next_cursor", "has_more" ], "additionalProperties": false }, "observed_at": { "anyOf": [ { "$ref": "#/definitions/MatchParticipantsEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "cached_at": { "anyOf": [ { "$ref": "#/definitions/MatchParticipantsEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "freshness_seconds": { "type": [ "number", "null" ] }, "cache_age_seconds": { "type": [ "number", "null" ] }, "completeness": { "type": "string", "enum": [ "full", "partial" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sources": { "type": "array", "items": { "type": "string" } } }, "required": [ "request_id", "generated_at" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#" } } } }, "404": { "description": "Not found" } }, "security": [ { "ApiKey": [] } ] } }, "/matches/{id}/games": { "get": { "summary": "Quarter and overtime score rows for a match", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Games" } }, "security": [ { "ApiKey": [] } ] } }, "/matches/{id}/observations": { "get": { "summary": "Observation time series for a match (cursor = sequence)", "description": "Oldest observations first. Sequence is monotonic within this match.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "cursor", "in": "query", "description": "Last seen sequence; results are returned in ascending sequence order.", "schema": { "type": "integer", "minimum": 0 } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 100, "maximum": 500 } } ], "responses": { "200": { "description": "Observations" } }, "security": [ { "ApiKey": [] } ] } }, "/matches/{id}/events": { "get": { "summary": "Domain-event history for a match (cursor = sequence)", "description": "Oldest events first. Sequence is monotonic within this match channel.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "cursor", "in": "query", "description": "Last seen sequence; results are returned in ascending sequence order.", "schema": { "type": "integer", "minimum": 0 } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 100, "maximum": 500 } } ], "responses": { "200": { "description": "Domain events" }, "404": { "description": "Not found" } }, "security": [ { "ApiKey": [] } ] } }, "/matches/{id}/player-stats": { "get": { "summary": "Player box score for a match", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Player game statistics", "content": { "application/json": { "schema": { "$ref": "#/definitions/PlayerGameStatsEnvelope", "definitions": { "PlayerGameStatsEnvelope": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "games_played": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "goals": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "assists": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "points": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "turnovers": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "shots": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "shots_on_goal": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "one_point_goals": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "two_point_goals": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "saves": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "save_pct": { "type": [ "number", "null" ] }, "faceoffs_won": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "faceoffs": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "faceoff_pct": { "type": [ "number", "null" ] }, "ground_balls": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "caused_turnovers": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "match_id": { "type": "string", "minLength": 1 }, "player": { "type": "object", "properties": { "id": { "$ref": "#/definitions/PlayerGameStatsEnvelope/properties/data/items/properties/match_id" }, "display_name": { "type": "string" }, "country_code": { "type": [ "string", "null" ] }, "first_name": { "$ref": "#/definitions/PlayerGameStatsEnvelope/properties/data/items/properties/player/properties/country_code" }, "last_name": { "$ref": "#/definitions/PlayerGameStatsEnvelope/properties/data/items/properties/player/properties/country_code" }, "jersey_number": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "position": { "$ref": "#/definitions/PlayerGameStatsEnvelope/properties/data/items/properties/player/properties/country_code" }, "position_name": { "$ref": "#/definitions/PlayerGameStatsEnvelope/properties/data/items/properties/player/properties/country_code" }, "college": { "$ref": "#/definitions/PlayerGameStatsEnvelope/properties/data/items/properties/player/properties/country_code" }, "hometown": { "$ref": "#/definitions/PlayerGameStatsEnvelope/properties/data/items/properties/player/properties/country_code" }, "experience": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "profile_url": { "$ref": "#/definitions/PlayerGameStatsEnvelope/properties/data/items/properties/player/properties/country_code" } }, "required": [ "id", "display_name", "country_code", "first_name", "last_name", "jersey_number", "position", "position_name", "college", "hometown", "experience", "profile_url" ], "additionalProperties": false }, "team": { "anyOf": [ { "type": "object", "properties": { "id": { "$ref": "#/definitions/PlayerGameStatsEnvelope/properties/data/items/properties/match_id" }, "name": { "type": "string" }, "abbreviation": { "$ref": "#/definitions/PlayerGameStatsEnvelope/properties/data/items/properties/player/properties/country_code" }, "location": { "$ref": "#/definitions/PlayerGameStatsEnvelope/properties/data/items/properties/player/properties/country_code" }, "location_code": { "$ref": "#/definitions/PlayerGameStatsEnvelope/properties/data/items/properties/player/properties/country_code" }, "conference": { "$ref": "#/definitions/PlayerGameStatsEnvelope/properties/data/items/properties/player/properties/country_code" }, "logo_url": { "$ref": "#/definitions/PlayerGameStatsEnvelope/properties/data/items/properties/player/properties/country_code" }, "team_color": { "$ref": "#/definitions/PlayerGameStatsEnvelope/properties/data/items/properties/player/properties/country_code" }, "background_color": { "$ref": "#/definitions/PlayerGameStatsEnvelope/properties/data/items/properties/player/properties/country_code" } }, "required": [ "id", "name", "abbreviation", "location", "location_code", "conference", "logo_url", "team_color", "background_color" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "games_played", "goals", "assists", "points", "turnovers", "shots", "shots_on_goal", "one_point_goals", "two_point_goals", "saves", "save_pct", "faceoffs_won", "faceoffs", "faceoff_pct", "ground_balls", "caused_turnovers", "match_id", "player", "team" ], "additionalProperties": false } }, "meta": { "type": "object", "properties": { "request_id": { "type": "string" }, "generated_at": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$" }, "pagination": { "type": "object", "properties": { "next_cursor": { "type": [ "string", "null" ] }, "has_more": { "type": "boolean" } }, "required": [ "next_cursor", "has_more" ], "additionalProperties": false }, "observed_at": { "anyOf": [ { "$ref": "#/definitions/PlayerGameStatsEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "cached_at": { "anyOf": [ { "$ref": "#/definitions/PlayerGameStatsEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "freshness_seconds": { "type": [ "number", "null" ] }, "cache_age_seconds": { "type": [ "number", "null" ] }, "completeness": { "type": "string", "enum": [ "full", "partial" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sources": { "type": "array", "items": { "type": "string" } } }, "required": [ "request_id", "generated_at" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#" } } } } }, "security": [ { "ApiKey": [] } ] } }, "/matches/{id}/team-stats": { "get": { "summary": "Team box score for a match", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Team game statistics", "content": { "application/json": { "schema": { "$ref": "#/definitions/TeamGameStatsEnvelope", "definitions": { "TeamGameStatsEnvelope": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "games_played": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "goals": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "assists": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "points": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "turnovers": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "shots": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "shots_on_goal": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "one_point_goals": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "two_point_goals": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "saves": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "save_pct": { "type": [ "number", "null" ] }, "faceoffs_won": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "faceoffs": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "faceoff_pct": { "type": [ "number", "null" ] }, "ground_balls": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "caused_turnovers": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "match_id": { "type": "string", "minLength": 1 }, "team": { "type": "object", "properties": { "id": { "$ref": "#/definitions/TeamGameStatsEnvelope/properties/data/items/properties/match_id" }, "name": { "type": "string" }, "abbreviation": { "type": [ "string", "null" ] }, "location": { "$ref": "#/definitions/TeamGameStatsEnvelope/properties/data/items/properties/team/properties/abbreviation" }, "location_code": { "$ref": "#/definitions/TeamGameStatsEnvelope/properties/data/items/properties/team/properties/abbreviation" }, "conference": { "$ref": "#/definitions/TeamGameStatsEnvelope/properties/data/items/properties/team/properties/abbreviation" }, "logo_url": { "$ref": "#/definitions/TeamGameStatsEnvelope/properties/data/items/properties/team/properties/abbreviation" }, "team_color": { "$ref": "#/definitions/TeamGameStatsEnvelope/properties/data/items/properties/team/properties/abbreviation" }, "background_color": { "$ref": "#/definitions/TeamGameStatsEnvelope/properties/data/items/properties/team/properties/abbreviation" } }, "required": [ "id", "name", "abbreviation", "location", "location_code", "conference", "logo_url", "team_color", "background_color" ], "additionalProperties": false }, "scores": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "shot_clock_expirations": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "games_played", "goals", "assists", "points", "turnovers", "shots", "shots_on_goal", "one_point_goals", "two_point_goals", "saves", "save_pct", "faceoffs_won", "faceoffs", "faceoff_pct", "ground_balls", "caused_turnovers", "match_id", "team", "scores", "shot_clock_expirations" ], "additionalProperties": false } }, "meta": { "type": "object", "properties": { "request_id": { "type": "string" }, "generated_at": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$" }, "pagination": { "type": "object", "properties": { "next_cursor": { "type": [ "string", "null" ] }, "has_more": { "type": "boolean" } }, "required": [ "next_cursor", "has_more" ], "additionalProperties": false }, "observed_at": { "anyOf": [ { "$ref": "#/definitions/TeamGameStatsEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "cached_at": { "anyOf": [ { "$ref": "#/definitions/TeamGameStatsEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "freshness_seconds": { "type": [ "number", "null" ] }, "cache_age_seconds": { "type": [ "number", "null" ] }, "completeness": { "type": "string", "enum": [ "full", "partial" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sources": { "type": "array", "items": { "type": "string" } } }, "required": [ "request_id", "generated_at" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#" } } } } }, "security": [ { "ApiKey": [] } ] } }, "/seasons/{id}/player-stats": { "get": { "summary": "Season player statistics", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 100, "maximum": 500 } } ], "responses": { "200": { "description": "Player season statistics", "content": { "application/json": { "schema": { "$ref": "#/definitions/PlayerSeasonStatsEnvelope", "definitions": { "PlayerSeasonStatsEnvelope": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "games_played": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "goals": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "assists": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "points": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "turnovers": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "shots": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "shots_on_goal": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "one_point_goals": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "two_point_goals": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "saves": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "save_pct": { "type": [ "number", "null" ] }, "faceoffs_won": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "faceoffs": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "faceoff_pct": { "type": [ "number", "null" ] }, "ground_balls": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "caused_turnovers": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "season_id": { "type": "string", "minLength": 1 }, "season_segment": { "type": [ "string", "null" ] }, "player": { "type": "object", "properties": { "id": { "$ref": "#/definitions/PlayerSeasonStatsEnvelope/properties/data/items/properties/season_id" }, "display_name": { "type": "string" }, "country_code": { "$ref": "#/definitions/PlayerSeasonStatsEnvelope/properties/data/items/properties/season_segment" }, "first_name": { "$ref": "#/definitions/PlayerSeasonStatsEnvelope/properties/data/items/properties/season_segment" }, "last_name": { "$ref": "#/definitions/PlayerSeasonStatsEnvelope/properties/data/items/properties/season_segment" }, "jersey_number": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "position": { "$ref": "#/definitions/PlayerSeasonStatsEnvelope/properties/data/items/properties/season_segment" }, "position_name": { "$ref": "#/definitions/PlayerSeasonStatsEnvelope/properties/data/items/properties/season_segment" }, "college": { "$ref": "#/definitions/PlayerSeasonStatsEnvelope/properties/data/items/properties/season_segment" }, "hometown": { "$ref": "#/definitions/PlayerSeasonStatsEnvelope/properties/data/items/properties/season_segment" }, "experience": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "profile_url": { "$ref": "#/definitions/PlayerSeasonStatsEnvelope/properties/data/items/properties/season_segment" } }, "required": [ "id", "display_name", "country_code", "first_name", "last_name", "jersey_number", "position", "position_name", "college", "hometown", "experience", "profile_url" ], "additionalProperties": false }, "team": { "anyOf": [ { "type": "object", "properties": { "id": { "$ref": "#/definitions/PlayerSeasonStatsEnvelope/properties/data/items/properties/season_id" }, "name": { "type": "string" }, "abbreviation": { "$ref": "#/definitions/PlayerSeasonStatsEnvelope/properties/data/items/properties/season_segment" }, "location": { "$ref": "#/definitions/PlayerSeasonStatsEnvelope/properties/data/items/properties/season_segment" }, "location_code": { "$ref": "#/definitions/PlayerSeasonStatsEnvelope/properties/data/items/properties/season_segment" }, "conference": { "$ref": "#/definitions/PlayerSeasonStatsEnvelope/properties/data/items/properties/season_segment" }, "logo_url": { "$ref": "#/definitions/PlayerSeasonStatsEnvelope/properties/data/items/properties/season_segment" }, "team_color": { "$ref": "#/definitions/PlayerSeasonStatsEnvelope/properties/data/items/properties/season_segment" }, "background_color": { "$ref": "#/definitions/PlayerSeasonStatsEnvelope/properties/data/items/properties/season_segment" } }, "required": [ "id", "name", "abbreviation", "location", "location_code", "conference", "logo_url", "team_color", "background_color" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "games_played", "goals", "assists", "points", "turnovers", "shots", "shots_on_goal", "one_point_goals", "two_point_goals", "saves", "save_pct", "faceoffs_won", "faceoffs", "faceoff_pct", "ground_balls", "caused_turnovers", "season_id", "season_segment", "player", "team" ], "additionalProperties": false } }, "meta": { "type": "object", "properties": { "request_id": { "type": "string" }, "generated_at": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$" }, "pagination": { "type": "object", "properties": { "next_cursor": { "type": [ "string", "null" ] }, "has_more": { "type": "boolean" } }, "required": [ "next_cursor", "has_more" ], "additionalProperties": false }, "observed_at": { "anyOf": [ { "$ref": "#/definitions/PlayerSeasonStatsEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "cached_at": { "anyOf": [ { "$ref": "#/definitions/PlayerSeasonStatsEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "freshness_seconds": { "type": [ "number", "null" ] }, "cache_age_seconds": { "type": [ "number", "null" ] }, "completeness": { "type": "string", "enum": [ "full", "partial" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sources": { "type": "array", "items": { "type": "string" } } }, "required": [ "request_id", "generated_at" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#" } } } } }, "security": [ { "ApiKey": [] } ] } }, "/seasons/{id}/team-stats": { "get": { "summary": "Season team statistics", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 100, "maximum": 500 } } ], "responses": { "200": { "description": "Team season statistics", "content": { "application/json": { "schema": { "$ref": "#/definitions/TeamSeasonStatsEnvelope", "definitions": { "TeamSeasonStatsEnvelope": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "games_played": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "goals": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "assists": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "points": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "turnovers": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "shots": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "shots_on_goal": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "one_point_goals": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "two_point_goals": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "saves": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "save_pct": { "type": [ "number", "null" ] }, "faceoffs_won": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "faceoffs": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "faceoff_pct": { "type": [ "number", "null" ] }, "ground_balls": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "caused_turnovers": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "season_id": { "type": "string", "minLength": 1 }, "season_segment": { "type": [ "string", "null" ] }, "team": { "type": "object", "properties": { "id": { "$ref": "#/definitions/TeamSeasonStatsEnvelope/properties/data/items/properties/season_id" }, "name": { "type": "string" }, "abbreviation": { "$ref": "#/definitions/TeamSeasonStatsEnvelope/properties/data/items/properties/season_segment" }, "location": { "$ref": "#/definitions/TeamSeasonStatsEnvelope/properties/data/items/properties/season_segment" }, "location_code": { "$ref": "#/definitions/TeamSeasonStatsEnvelope/properties/data/items/properties/season_segment" }, "conference": { "$ref": "#/definitions/TeamSeasonStatsEnvelope/properties/data/items/properties/season_segment" }, "logo_url": { "$ref": "#/definitions/TeamSeasonStatsEnvelope/properties/data/items/properties/season_segment" }, "team_color": { "$ref": "#/definitions/TeamSeasonStatsEnvelope/properties/data/items/properties/season_segment" }, "background_color": { "$ref": "#/definitions/TeamSeasonStatsEnvelope/properties/data/items/properties/season_segment" } }, "required": [ "id", "name", "abbreviation", "location", "location_code", "conference", "logo_url", "team_color", "background_color" ], "additionalProperties": false }, "scores": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "games_played", "goals", "assists", "points", "turnovers", "shots", "shots_on_goal", "one_point_goals", "two_point_goals", "saves", "save_pct", "faceoffs_won", "faceoffs", "faceoff_pct", "ground_balls", "caused_turnovers", "season_id", "season_segment", "team", "scores" ], "additionalProperties": false } }, "meta": { "type": "object", "properties": { "request_id": { "type": "string" }, "generated_at": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$" }, "pagination": { "type": "object", "properties": { "next_cursor": { "type": [ "string", "null" ] }, "has_more": { "type": "boolean" } }, "required": [ "next_cursor", "has_more" ], "additionalProperties": false }, "observed_at": { "anyOf": [ { "$ref": "#/definitions/TeamSeasonStatsEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "cached_at": { "anyOf": [ { "$ref": "#/definitions/TeamSeasonStatsEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "freshness_seconds": { "type": [ "number", "null" ] }, "cache_age_seconds": { "type": [ "number", "null" ] }, "completeness": { "type": "string", "enum": [ "full", "partial" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sources": { "type": "array", "items": { "type": "string" } } }, "required": [ "request_id", "generated_at" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#" } } } } }, "security": [ { "ApiKey": [] } ] } }, "/transactions": { "get": { "summary": "League-wide player transaction wire", "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 100, "maximum": 500 } } ], "responses": { "200": { "description": "Transactions", "content": { "application/json": { "schema": { "$ref": "#/definitions/TransactionsEnvelope", "definitions": { "TransactionsEnvelope": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "occurred_on": { "type": [ "string", "null" ] }, "player": { "anyOf": [ { "type": "object", "properties": { "id": { "$ref": "#/definitions/TransactionsEnvelope/properties/data/items/properties/id" }, "display_name": { "type": "string" }, "country_code": { "$ref": "#/definitions/TransactionsEnvelope/properties/data/items/properties/occurred_on" }, "first_name": { "$ref": "#/definitions/TransactionsEnvelope/properties/data/items/properties/occurred_on" }, "last_name": { "$ref": "#/definitions/TransactionsEnvelope/properties/data/items/properties/occurred_on" }, "jersey_number": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "position": { "$ref": "#/definitions/TransactionsEnvelope/properties/data/items/properties/occurred_on" }, "position_name": { "$ref": "#/definitions/TransactionsEnvelope/properties/data/items/properties/occurred_on" }, "college": { "$ref": "#/definitions/TransactionsEnvelope/properties/data/items/properties/occurred_on" }, "hometown": { "$ref": "#/definitions/TransactionsEnvelope/properties/data/items/properties/occurred_on" }, "experience": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "profile_url": { "$ref": "#/definitions/TransactionsEnvelope/properties/data/items/properties/occurred_on" } }, "required": [ "id", "display_name", "country_code", "first_name", "last_name", "jersey_number", "position", "position_name", "college", "hometown", "experience", "profile_url" ], "additionalProperties": false }, { "type": "null" } ] }, "player_name": { "$ref": "#/definitions/TransactionsEnvelope/properties/data/items/properties/occurred_on" }, "position": { "$ref": "#/definitions/TransactionsEnvelope/properties/data/items/properties/occurred_on" }, "move_from": { "$ref": "#/definitions/TransactionsEnvelope/properties/data/items/properties/occurred_on" }, "move_to": { "$ref": "#/definitions/TransactionsEnvelope/properties/data/items/properties/occurred_on" }, "details": { "$ref": "#/definitions/TransactionsEnvelope/properties/data/items/properties/occurred_on" } }, "required": [ "id", "occurred_on", "player", "player_name", "position", "move_from", "move_to", "details" ], "additionalProperties": false } }, "meta": { "type": "object", "properties": { "request_id": { "type": "string" }, "generated_at": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$" }, "pagination": { "type": "object", "properties": { "next_cursor": { "type": [ "string", "null" ] }, "has_more": { "type": "boolean" } }, "required": [ "next_cursor", "has_more" ], "additionalProperties": false }, "observed_at": { "anyOf": [ { "$ref": "#/definitions/TransactionsEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "cached_at": { "anyOf": [ { "$ref": "#/definitions/TransactionsEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "freshness_seconds": { "type": [ "number", "null" ] }, "cache_age_seconds": { "type": [ "number", "null" ] }, "completeness": { "type": "string", "enum": [ "full", "partial" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sources": { "type": "array", "items": { "type": "string" } } }, "required": [ "request_id", "generated_at" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#" } } } } }, "security": [ { "ApiKey": [] } ] } }, "/players/{id}/transactions": { "get": { "summary": "Transaction history for a player", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 100, "maximum": 500 } } ], "responses": { "200": { "description": "Player transactions" } }, "security": [ { "ApiKey": [] } ] } }, "/odds/events": { "get": { "summary": "List canonical odds events", "parameters": [ { "name": "cursor", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 100, "maximum": 500 } } ], "responses": { "200": { "description": "Odds events", "content": { "application/json": { "schema": { "$ref": "#/definitions/OddsEventsEnvelope", "definitions": { "OddsEventsEnvelope": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "league": { "type": "string" }, "starts_at": { "type": [ "string", "null" ] }, "link_status": { "type": "string", "enum": [ "unlinked", "suggested", "verified", "rejected" ] }, "fixture_id": { "$ref": "#/definitions/OddsEventsEnvelope/properties/data/items/properties/starts_at" }, "home_team": { "type": "object", "properties": { "id": { "$ref": "#/definitions/OddsEventsEnvelope/properties/data/items/properties/starts_at" }, "name": { "$ref": "#/definitions/OddsEventsEnvelope/properties/data/items/properties/starts_at" } }, "required": [ "id", "name" ], "additionalProperties": false }, "away_team": { "type": "object", "properties": { "id": { "$ref": "#/definitions/OddsEventsEnvelope/properties/data/items/properties/starts_at" }, "name": { "$ref": "#/definitions/OddsEventsEnvelope/properties/data/items/properties/starts_at" } }, "required": [ "id", "name" ], "additionalProperties": false } }, "required": [ "id", "league", "starts_at", "link_status", "fixture_id", "home_team", "away_team" ], "additionalProperties": false } }, "meta": { "type": "object", "properties": { "request_id": { "type": "string" }, "generated_at": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$" }, "pagination": { "type": "object", "properties": { "next_cursor": { "type": [ "string", "null" ] }, "has_more": { "type": "boolean" } }, "required": [ "next_cursor", "has_more" ], "additionalProperties": false }, "observed_at": { "anyOf": [ { "$ref": "#/definitions/OddsEventsEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "cached_at": { "anyOf": [ { "$ref": "#/definitions/OddsEventsEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "freshness_seconds": { "type": [ "number", "null" ] }, "cache_age_seconds": { "type": [ "number", "null" ] }, "completeness": { "type": "string", "enum": [ "full", "partial" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sources": { "type": "array", "items": { "type": "string" } } }, "required": [ "request_id", "generated_at" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#" } } } } }, "security": [ { "ApiKey": [] } ] } }, "/odds/events/{id}": { "get": { "summary": "Odds event with every provider’s latest prices", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Odds event detail", "content": { "application/json": { "schema": { "$ref": "#/definitions/OddsEventDetailEnvelope", "definitions": { "OddsEventDetailEnvelope": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "league": { "type": "string" }, "starts_at": { "type": [ "string", "null" ] }, "link_status": { "type": "string", "enum": [ "unlinked", "suggested", "verified", "rejected" ] }, "fixture_id": { "$ref": "#/definitions/OddsEventDetailEnvelope/properties/data/properties/starts_at" }, "home_team": { "type": "object", "properties": { "id": { "$ref": "#/definitions/OddsEventDetailEnvelope/properties/data/properties/starts_at" }, "name": { "$ref": "#/definitions/OddsEventDetailEnvelope/properties/data/properties/starts_at" } }, "required": [ "id", "name" ], "additionalProperties": false }, "away_team": { "type": "object", "properties": { "id": { "$ref": "#/definitions/OddsEventDetailEnvelope/properties/data/properties/starts_at" }, "name": { "$ref": "#/definitions/OddsEventDetailEnvelope/properties/data/properties/starts_at" } }, "required": [ "id", "name" ], "additionalProperties": false }, "prices": { "type": "array", "items": { "type": "object", "properties": { "provider": { "type": "string" }, "market_id": { "$ref": "#/definitions/OddsEventDetailEnvelope/properties/data/properties/id" }, "market_key": { "type": "string", "enum": [ "moneyline", "spread", "total", "futures", "prop" ] }, "provider_market_label": { "$ref": "#/definitions/OddsEventDetailEnvelope/properties/data/properties/starts_at" }, "period": { "$ref": "#/definitions/OddsEventDetailEnvelope/properties/data/properties/starts_at" }, "line": { "$ref": "#/definitions/OddsEventDetailEnvelope/properties/data/properties/starts_at" }, "status": { "type": "string" }, "outcome": { "type": "string" }, "decimal_odds": { "$ref": "#/definitions/OddsEventDetailEnvelope/properties/data/properties/starts_at" }, "original_price": { "$ref": "#/definitions/OddsEventDetailEnvelope/properties/data/properties/starts_at" }, "original_format": { "$ref": "#/definitions/OddsEventDetailEnvelope/properties/data/properties/starts_at" }, "is_live": { "type": "boolean" }, "suspended": { "type": "boolean" }, "observed_at": { "$ref": "#/definitions/OddsEventDetailEnvelope/properties/data/properties/starts_at" } }, "required": [ "provider", "market_id", "market_key", "provider_market_label", "period", "line", "status", "outcome", "decimal_odds", "original_price", "original_format", "is_live", "suspended", "observed_at" ], "additionalProperties": false } } }, "required": [ "id", "league", "starts_at", "link_status", "fixture_id", "home_team", "away_team", "prices" ], "additionalProperties": false }, "meta": { "type": "object", "properties": { "request_id": { "type": "string" }, "generated_at": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$" }, "pagination": { "type": "object", "properties": { "next_cursor": { "type": [ "string", "null" ] }, "has_more": { "type": "boolean" } }, "required": [ "next_cursor", "has_more" ], "additionalProperties": false }, "observed_at": { "anyOf": [ { "$ref": "#/definitions/OddsEventDetailEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "cached_at": { "anyOf": [ { "$ref": "#/definitions/OddsEventDetailEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "freshness_seconds": { "type": [ "number", "null" ] }, "cache_age_seconds": { "type": [ "number", "null" ] }, "completeness": { "type": "string", "enum": [ "full", "partial" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sources": { "type": "array", "items": { "type": "string" } } }, "required": [ "request_id", "generated_at" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#" } } } } }, "security": [ { "ApiKey": [] } ] } }, "/odds/markets/{id}/prices": { "get": { "summary": "Historical price observations for a provider market", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "cursor", "in": "query", "description": "Last seen sequence; results are returned in ascending sequence order.", "schema": { "type": "integer", "minimum": 0 } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 100, "maximum": 500 } } ], "responses": { "200": { "description": "Price observations", "content": { "application/json": { "schema": { "$ref": "#/definitions/PriceObservationsEnvelope", "definitions": { "PriceObservationsEnvelope": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "sequence": { "type": "integer" }, "outcome": { "type": "string" }, "decimal_odds": { "type": [ "string", "null" ] }, "original_price": { "$ref": "#/definitions/PriceObservationsEnvelope/properties/data/items/properties/decimal_odds" }, "original_format": { "$ref": "#/definitions/PriceObservationsEnvelope/properties/data/items/properties/decimal_odds" }, "is_live": { "type": "boolean" }, "suspended": { "type": "boolean" }, "observed_at": { "type": "string", "minLength": 1 } }, "required": [ "sequence", "outcome", "decimal_odds", "original_price", "original_format", "is_live", "suspended", "observed_at" ], "additionalProperties": false } }, "meta": { "type": "object", "properties": { "request_id": { "type": "string" }, "generated_at": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$" }, "pagination": { "type": "object", "properties": { "next_cursor": { "type": [ "string", "null" ] }, "has_more": { "type": "boolean" } }, "required": [ "next_cursor", "has_more" ], "additionalProperties": false }, "observed_at": { "anyOf": [ { "$ref": "#/definitions/PriceObservationsEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "cached_at": { "anyOf": [ { "$ref": "#/definitions/PriceObservationsEnvelope/properties/meta/properties/generated_at" }, { "type": "null" } ] }, "freshness_seconds": { "type": [ "number", "null" ] }, "cache_age_seconds": { "type": [ "number", "null" ] }, "completeness": { "type": "string", "enum": [ "full", "partial" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sources": { "type": "array", "items": { "type": "string" } } }, "required": [ "request_id", "generated_at" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#" } } } } }, "security": [ { "ApiKey": [] } ] } }, "/realtime/tickets": { "post": { "summary": "Mint single-use WebSocket ticket", "responses": { "200": { "description": "Ticket" } }, "security": [ { "ApiKey": [] } ] } }, "/usage": { "get": { "summary": "Current quota usage", "responses": { "200": { "description": "Usage", "content": { "application/json": { "schema": { "$ref": "#/definitions/UsageEnvelope", "definitions": { "UsageEnvelope": { "type": "object", "properties": { "data": { "type": "object", "properties": { "plan": { "type": "string" }, "period_start": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$" }, "period_end": { "$ref": "#/definitions/UsageEnvelope/properties/data/properties/period_start" }, "rest_calls_used": { "type": "integer", "minimum": 0 }, "rest_calls_limit": { "type": "integer", "minimum": 0 }, "outbound_messages_used": { "type": "integer", "minimum": 0 }, "outbound_messages_limit": { "type": "integer", "minimum": 0 }, "sockets_active": { "type": "integer", "minimum": 0 }, "sockets_limit": { "type": "integer", "minimum": 0 }, "markets_entitled": { "type": "boolean" } }, "required": [ "plan", "period_start", "period_end", "rest_calls_used", "rest_calls_limit", "outbound_messages_used", "outbound_messages_limit", "sockets_active", "sockets_limit", "markets_entitled" ], "additionalProperties": false }, "meta": { "type": "object", "properties": { "request_id": { "type": "string" }, "generated_at": { "$ref": "#/definitions/UsageEnvelope/properties/data/properties/period_start" }, "pagination": { "type": "object", "properties": { "next_cursor": { "type": [ "string", "null" ] }, "has_more": { "type": "boolean" } }, "required": [ "next_cursor", "has_more" ], "additionalProperties": false }, "observed_at": { "anyOf": [ { "$ref": "#/definitions/UsageEnvelope/properties/data/properties/period_start" }, { "type": "null" } ] }, "cached_at": { "anyOf": [ { "$ref": "#/definitions/UsageEnvelope/properties/data/properties/period_start" }, { "type": "null" } ] }, "freshness_seconds": { "type": [ "number", "null" ] }, "cache_age_seconds": { "type": [ "number", "null" ] }, "completeness": { "type": "string", "enum": [ "full", "partial" ] }, "confidence": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sources": { "type": "array", "items": { "type": "string" } } }, "required": [ "request_id", "generated_at" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#" } } } } }, "security": [ { "ApiKey": [] } ] } } }, "components": { "securitySchemes": { "ApiKey": { "type": "http", "scheme": "bearer", "bearerFormat": "lax_live_" } }, "schemas": { "ProblemDetails": { "type": "object", "required": [ "type", "title", "status", "code", "request_id" ], "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer" }, "detail": { "type": "string" }, "code": { "type": "string" }, "request_id": { "type": "string" } } } } } }