-
Notifications
You must be signed in to change notification settings - Fork 0
API Documentation
The Vintage Data API provides endpoints to retrieve match and event data from the MTGO Vintage Metagame dataset.
- Requests are limited to 100 per minute.
- No authentication is required.
Redirects to the GitHub repository.
Retrieves raw match data.
Query Parameter(s):
- start (string, optional): Start date (YYYY-MM-DD). Default: 2024-08-25.
- end (string, optional): End date (YYYY-MM-DD). Default: Current Date.
- page (integer, optional): Page number. Default: 1.
Retrieves a specific match by its match_id.
URL Parameter(s):
- match_id (integer, required): Match ID.
Retrieves all matches involving a specific player.
URL Parameter(s):
- player_id (string, required): Player identifier.
Query Parameter(s):
- start (string, optional): Start date (YYYY-MM-DD). Default: 2024-08-25.
- end (string, optional): End date (YYYY-MM-DD). Default: Current Date.
- page (integer, optional): Page number. Default: 1.
Retrieves all matches from a specific event.
URL Parameter(s):
- event_id (integer, required): Event ID.
Retrieves all events. Returns event details and total number of players per event.
Query Parameter(s):
- start (string, optional): Start date (YYYY-MM-DD). Default: 2024-08-25.
- end (string, optional): End date (YYYY-MM-DD). Default: Current Date.
- page (integer, optional): Page number. Default: 1.
Retrieves event details by event_id.
URL Parameter(s):
event_id (integer, required): The ID of the event.
Retrieves event standings by event_id.
URL Parameter(s):
event_id (integer, required): The ID of the event.
Query Parameter(s):
rank (integer, optional): Search for a player of a specific rank. Default: 0 (full standings).
Retrieves event rank and record for a specific player (P1) by event_id.
URL Parameter(s):
event_id (integer, required): The ID of the event.
P1 (string, required): Player identifier.
Retrieves events played by a specific player (P1). Returns a JSON object containing event details, deck details, and win-loss record.
URL Parameter(s):
P1 (string, required): Player identifier.
Query Parameter(s):
start (string, optional): Start date (YYYY-MM-DD). Default: 2024-08-25.
end (string, optional): End date (YYYY-MM-DD). Default: Tomorrow.
page (integer, optional): Page number for pagination. Default: 1.
Retrieves a list of all valid decks.
Retrieves details of a specific deck by deck_id.
URL Parameter(s):
deck_id (integer, required): The ID of the deck.
Retrieves a list of valid event types (e.g. Challenge, Showcase, etc.).
Retrieves details of a specific event type by event_type_id.
URL Parameter(s):
event_type_id (integer, required): The ID of the event type.
Retrieves a list of all load reports. Load Reports contain statistics such as matches deleted, matches processed, matches skipped, etc. Matches are processed weekly on Sundays at 2am PST.
Retrieves a specific load report using load_rpt_id.
URL Parameter(s):
load_rpt_id (integer, required): The ID of the load report.
Retrieves a list of all event rejections. Event Rejections will contain the post-processed event data along with a Rejection Type and Rejection Reason Text.
Retrieves event rejections for a specific load_rpt_id.
URL Parameter(s):
load_rpt_id (integer, required): The ID of the load report.
Retrieves a list of all match rejections. Match Rejections will contain the post-processed event data along with a Rejection Type and Rejection Reason Text.
Retrieves match rejections for a specific load_rpt_id.
URL Parameter(s):
load_rpt_id (integer, required): The ID of the load report.
All requests are logged and inserted into the "API_LOGGING_STATS" table to track API Endpoint usage statistics. See Data Dictionary for more information.
-
400 Bad Request: Invalid query parameters. -
404 Not Found: Requested resource does not exist. -
500 Internal Server Error: Unexpected server error.
curl -X GET "https://api.vintagedata.io/matches/?start=2024-08-25&end=2024-10-30&page=1"
curl -X GET "https://api.vintagedata.io/events/?start=2024-08-25&end=2024-10-30&page=1"
curl -X GET "https://api.vintagedata.io/events/player/IamActuallyLvL1/"
curl -X GET "https://api.vintagedata.io/load-reports/"