1. Enter your credentials
Open Authentication at the top of the reference. Query authentication
(ApiKeyQuery) is selected by default: enter your API key as the credential
value, replacing the API_KEY placeholder. The client adds it to the URL as
api_key.
Alternatively, select Bearer authentication (BearerAuth) and enter the same
key without the Bearer prefix; the client adds it to the Authorization
header instead of the URL.
The documentation does not persist credentials across a reload. They are sent only when you explicitly run a request against the API. Use a development key from admin.soccersapi.com/api-tokens.
The legacy user + token option is deprecated and provided only for existing
integrations. See Authentication methods
to migrate. Select one method per request.
2. Pick the operation
Open a route in the sidebar, for example Fixtures, and choose the operation
you need, such as Match by ID or Fixtures by date. Each operation page
shows only the parameters that apply to it; the t value is already part of
the request. The route header above the operations keeps the full operations
table, the include values and the request examples of the route.
3. Send the request
Press Send. The response panel shows the HTTP status, the response time and
the JSON body. The Examples selector in the response section shows a
captured response for each t value, so you can see the shape before calling.
4. Copy the request
The code snippet next to the request is generated for the selected client. The available clients include cURL, JavaScript, Node.js, Python, PHP, Java, C#, Go and Ruby. Remove credentials before sharing generated code. See Code Examples for complete placeholder-only samples.
Notes
- Bearer authentication keeps the key out of the URL. Query authentication can expose it in browser history and request logs. Redact credentials before sharing requests, use a development key and rotate it if it leaks.
- Production API keys belong on your server, not in frontend application code.
- Requests made from the explorer count against the request allowance of the
account;
meta.requests_leftshows what is left. - The explorer is a static page built from the OpenAPI contract with
npm run docs:build; see the repository README to run it locally.