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:
- Set the base URL to
https://api.gosportsapi.com/v1. - Add your API key as the
x-api-keyheader. Keep it in a secret variable rather than in the collection itself, so it isn’t shared when you export. - Send a request to
/football/fixturesto check that everything works.
Until the files are published, every endpoint reference page has request examples in cURL, JavaScript, Python and PHP.