Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

sportsfoundry

Stable customer contract over SportsFoundry canonical sports data. Supplier, routing, rights and operator implementation details are intentionally excluded.

This Python package is automatically generated by the OpenAPI Generator project:

  • API version: 1.0.0
  • Package version: 0.1.0a1
  • Generator version: 7.24.0
  • Build package: org.openapitools.codegen.languages.PythonClientCodegen For more information, please visit https://sportsfoundry.app

Requirements.

Python 3.10+

Installation & Usage

pip install

If the python package is hosted on a repository, you can install directly using:

pip install git+https://github.com/SportsFoundry/sdks.git

(you may need to run pip with root permission: sudo pip install git+https://github.com/SportsFoundry/sdks.git)

Then import the package:

import sportsfoundry

Setuptools

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import sportsfoundry

Tests

Execute pytest to run the tests.

Getting Started

Please follow the installation procedure and then run the following:

import sportsfoundry
from sportsfoundry.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to https://sportsfoundry.app
# See configuration.py for a list of all supported configuration parameters.
configuration = sportsfoundry.Configuration(
    host = "https://sportsfoundry.app"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure API key authorization: ApiKeyAuth
configuration.api_key['ApiKeyAuth'] = os.environ["API_KEY"]

# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['ApiKeyAuth'] = 'Bearer'


# Enter a context with an instance of the API client
with sportsfoundry.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = sportsfoundry.DefaultApi(api_client)
    competition_edition_id = UUID('38400000-8cf0-11bd-b23e-10b96e4ef00d') # UUID |  (optional)
    team_id = UUID('38400000-8cf0-11bd-b23e-10b96e4ef00d') # UUID |  (optional)
    status = sportsfoundry.EventStatus() # EventStatus |  (optional)
    var_from = '2013-10-20T19:20:30+01:00' # datetime |  (optional)
    to = '2013-10-20T19:20:30+01:00' # datetime |  (optional)
    cursor = 'cursor_example' # str |  (optional)
    limit = 50 # int |  (optional) (default to 50)

    try:
        api_response = api_instance.find_events(competition_edition_id=competition_edition_id, team_id=team_id, status=status, var_from=var_from, to=to, cursor=cursor, limit=limit)
        print("The response of DefaultApi->find_events:\n")
        pprint(api_response)
    except ApiException as e:
        print("Exception when calling DefaultApi->find_events: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to https://sportsfoundry.app

Class Method HTTP request Description
DefaultApi find_events GET /api/v1/events
DefaultApi get_competition GET /api/v1/competitions/{competitionId}
DefaultApi get_current_squad GET /api/v1/teams/{teamId}/squad
DefaultApi get_edition GET /api/v1/editions/{editionId}
DefaultApi get_event GET /api/v1/events/{eventId}
DefaultApi get_player GET /api/v1/players/{playerId}
DefaultApi get_sport GET /api/v1/sports/{sportId}
DefaultApi get_standings GET /api/v1/editions/{editionId}/standings
DefaultApi get_team GET /api/v1/teams/{teamId}
DefaultApi get_venue GET /api/v1/venues/{venueId}
DefaultApi list_competitions GET /api/v1/competitions
DefaultApi list_editions GET /api/v1/editions
DefaultApi list_sports GET /api/v1/sports
DefaultApi list_teams GET /api/v1/teams
DefaultApi list_venues GET /api/v1/venues
DefaultApi search_football GET /api/v1/search

Documentation For Models

Documentation For Authorization

Authentication schemes defined for the API:

ApiKeyAuth

  • Type: API key
  • API key parameter name: X-API-Key
  • Location: HTTP header

Author

Metadata

Release files for sportsfoundry 0.1.0a1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sportsfoundry 0.1.0a1
File Size Uploaded Provenance
sportsfoundry-0.1.0a1.tar.gz 38.8 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for sportsfoundry 0.1.0a1
File Interpreter ABI Platform
sportsfoundry-0.1.0a1-py3-none-any.whl Python 3 none any Details

Total release size: 101.9 kB

Release files / sportsfoundry-0.1.0a1.tar.gz

Download URL sportsfoundry-0.1.0a1.tar.gz
Size 38.8 kB
Tags Source
SHA-256 checksum
How to use checksums
a63526ab1b9ca0184cc5ee481b78ce85e69bbca9e7518e18821a186407057bb2
BLAKE2b-256 checksum
How to use checksums
ecf746faf24ba6c7ac5e068e8b61b1996dc93b71ad93dc555c13651a54ed543a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 18, 2026.

Transparency log

Release files / sportsfoundry-0.1.0a1-py3-none-any.whl

Download URL sportsfoundry-0.1.0a1-py3-none-any.whl
Size 63.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5b86a1d60cccaf71b0d69aed1b6a1ef204a01563bea1b5669e127bc57517f0b6
BLAKE2b-256 checksum
How to use checksums
4bba1743be2912c3cb6614ba25b97a2c13f9c913d1281d38a058db214bbb6842
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 18, 2026.

Transparency log

Security for sportsfoundry 0.1.0a1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for sportsfoundry-0.1.0a1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page