OpenAPI / Swagger Browser

Browse OpenAPI 3.0 specifications for sports API providers that publish one. Pick a provider to inspect its endpoints, parameters, and response codes, and import the spec into Postman or Stoplight with one click.

For OpenAPI-first teamsREST · OpenAPI 3.0 · 8 sports

API-Sports — OpenAPI spec, multi-sport coverage

API-Sports publishes a machine-readable OpenAPI spec and supports 8 sports with consistent endpoint shapes across leagues, fixtures, standings, and odds. A great choice for teams that want SDK generation from spec.

✓ OpenAPI 3.0 spec✓ 8 sports supported✓ Free tier available✓ Generated SDKs

Free tier · Starter $24.99/moOpenAPI · REST · SDKs

Get Started with API-Sports Read full review →

Provider with OpenAPI spec

Showing 40 of 105 providers that publish an OpenAPI spec.

View official spec

Endpoints

5 routes · Football

Method	Path	Summary
GET	`/fixtures`	Get fixtures by league and season
GET	`/standings`	Get league standings
GET	`/teams`	Get team information
GET	`/leagues`	List available leagues
GET	`/live`	Get live fixtures

openapi.json

{
  "openapi": "3.0.3",
  "info": {
    "title": "API-Sports Sports API",
    "version": "1.0.0",
    "description": "Synthetic OpenAPI 3.0 specification for API-Sports covering Football endpoints. This is a representative schema. Refer to the official spec link for the canonical definition.",
    "contact": {
      "name": "API-Sports",
      "url": "https://api-sports.com"
    }
  },
  "servers": [
    {
      "url": "https://api.api-sports.com/v1",
      "description": "Production"
    }
  ],
  "paths": {
    "/fixtures": {
      "get": {
        "method": "GET",
        "path": "/fixtures",
        "summary": "Get fixtures by league and season",
        "description": "Returns a list of fixtures for a given league and optional season.",
        "parameters": [
          {
            "name": "league",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response with fixture array."
          },
          "401": {
            "description": "Invalid or missing API key."
          }
        }
      }
    },
    "/standings": {
      "get": {
        "method": "GET",
        "path": "/standings",
        "summary": "Get league standings",
        "description": "Returns league standings (table) for a given league and season.",
        "parameters": [
          {
            "name": "league",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "season",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response with standings array."
          }
        }
      }
    },
    "/teams": {
      "get": {
        "method": "GET",
        "path": "/teams",
        "summary": "Get team information",
        "description": "Returns team information, including country, venue, and season stats.",
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response with team objects."
          }
        }
      }
    },
    "/leagues": {
      "get": {
        "method": "GET",
        "path": "/leagues",
        "summary": "List available leagues",
        "description": "Returns the list of leagues available with country and season info.",
        "parameters": [
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response with league array."
          }
        }
      }
    },
    "/live": {
      "get": {
        "method": "GET",
        "path": "/live",
        "summary": "Get live fixtures",
        "description": "Returns all currently in-play fixtures and live scores.",
        "responses": {
          "200": {
            "description": "Successful response with live fixture array."
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key",
        "description": "API key issued by the provider."
      }
    }
  }
}

What is OpenAPI?

OpenAPI (formerly Swagger) is a vendor-neutral, machine-readable description format for HTTP APIs. A spec file lists every endpoint, parameter, response shape, and authentication scheme, which lets you:

Generate client SDKs in any language
Auto-build API documentation
Import endpoints into Postman / Stoplight / Insomnia
Run contract tests against the live API

How to import into Postman

Open Postman and click Import.
Paste the official spec URL or upload openapi.json.
Postman builds a collection with one request per endpoint.
Add your API key under the collection's Authorization tab.

How to import into Stoplight

In Stoplight, create a new API project.
Choose Import → OpenAPI 3.
Paste the spec URL or upload the file.
Stoplight renders interactive docs and a hosted mock server.

The spec shown here is synthetic

To avoid stale or fabricated contracts, we render a representative schema based on the provider's primary sport. Always use the "View official spec" button above for the canonical, version-pinned definition.