Resources / Downloads

Downloads

Machine-readable descriptions of the API for code generators, API clients and testing tools.

OpenAPI specification

A machine-readable description of every endpoint, parameter and response schema in this reference.

  • Generate typed clients
  • Run a mock server
  • Validate responses in tests
[Download URL to be provided]

Postman collection

Every endpoint as a ready-to-send request, grouped by sport, so you can explore the API without writing code.

  • Try endpoints in Postman
  • Share requests with your team
[Download URL to be provided]

Setting up your environment

Both files describe the same API as this reference. After importing one:

  1. Set the base URL to https://api.gosportsapi.com/v1.
  2. Add your API key as the x-api-key header. Keep it in a secret variable rather than in the collection itself, so it isn’t shared when you export.
  3. Send a request to /football/fixtures to check that everything works.

Until the files are published, every endpoint reference page has request examples in cURL, JavaScript, Python and PHP.