find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/sportstatsapi:sportstatsapi-boxing-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  contact:
    name: SportStatsAPI
    url: https://sportstatsapi.com
  description: 'Every public endpoint of SportStatsAPI. Endpoints marked with x-x402 can also be paid per call by an AI agent; the curated list of those is https://api.sportstatsapi.com/api/openapi.agents.json.


    Authentication: an API key (header X-API-Key, or Authorization: Bearer ), or without a key an x402 payment (header PAYMENT-SIGNATURE, USDC on Base). Prices and payment offers: https://api.sportstatsapi.com/.well-known/x402. Docs for AI models: https://api.sportstatsapi.com/llms.txt. MCP server: https://mcp.sportstatsapi.com/mcp.'
  summary: Sports data API and x402 pay-per-call endpoints
  title: SportStats Boxing API
  version: '1.0'
servers:
- url: https://api.sportstatsapi.com/api/v1
tags:
- name: boxing
paths:
  /boxing/champions:
    get:
      description: 'The current world champions per weight class and body (WBA, WBC, IBF, WBO, The Ring) from Wikipedia''s lists, men and women: status (champion; WBA super or regular; interim), record as listed and the date the title was won. Vacant titles are not listed.'
      operationId: getBoxingChampions
      parameters:
      - description: men or women
        in: query
        name: sex
        schema:
          type: string
      - description: Heavyweight, Light heavyweight, ...
        in: query
        name: weight_class
        schema:
          type: string
      - description: WBA, WBC, IBF, WBO or Ring
        in: query
        name: body
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/middleware.Response'
                - properties:
                    data:
                      $ref: '#/components/schemas/dto.BoxingChampionsResponse'
                  type: object
          description: OK
        '401':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/middleware.Response'
                - properties:
                    error:
                      $ref: '#/components/schemas/middleware.ErrorInfo'
                  type: object
          description: Unauthorized
        '500':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/middleware.Response'
                - properties:
                    error:
                      $ref: '#/components/schemas/middleware.ErrorInfo'
                  type: object
          description: Internal Server Error
      security:
      - ApiKeyAuth: []
      - BearerAuth: []
      summary: Get the current world boxing champions
      tags:
      - boxing
  /boxing/events:
    get:
      description: 'Boxing events of the last and the current year from Wikipedia (CC BY-SA 4.0): cards of the fight articles and Zuffa Boxing (kind card) and world title fights from the champions'' record tables (kind title_fight). Latest first, with venue, city and the main event''s winner.'
      operationId: getBoxingEvents
      parameters:
      - description: Year (2026)
        in: query
        name: season
        schema:
          type: string
      - description: scheduled, live, finished or no_results
        in: query
        name: status
        schema:
          type: string
      - description: card or title_fight
        in: query
        name: kind
        schema:
          type: string
      - description: Events on or after this date (YYYY-MM-DD)
        in: query
        name: date_from
        schema:
          type: string
      - description: Events on or before this date (YYYY-MM-DD)
        in: query
        name: date_to
        schema:
          type: string
      - description: Maximum results (1-100)
        in: query
        name: limit
        schema:
          default: 50
          type: integer
      - description: Results to skip
        in: query
        name: offset
        schema:
          default: 0
          type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/middleware.Response'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/dto.BoxingEventResponse'
                      type: array
                    meta:
                      $ref: '#/components/schemas/middleware.MetaInfo'
                  type: object
          description: OK
        '401':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/middleware.Response'
                - properties:
                    error:
                      $ref: '#/components/schemas/middleware.ErrorInfo'
                  type: object
          description: Unauthorized
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '500':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/middleware.Response'
                - properties:
                    error:
                      $ref: '#/components/schemas/middleware.ErrorInfo'
                  type: object
          description: Internal Server Error
      security:
      - ApiKeyAuth: []
      - BearerAuth: []
      - x402: []
      summary: List boxing events
      tags:
      - boxing
      x-x402:
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        currency: USDC
        discovery: https://api.sportstatsapi.com/.well-known/x402
        minSinglePayment: '0.01'
        network: eip155:8453
        price: '0.002'
  /boxing/events/{id}:
    get:
      description: 'An event with every bout of its card, main event first: weight class, world titles at stake (WBA, WBC, IBF, WBO, Ring), fighters, result, method (KO, TKO, UD, SD, MD, RTD, DQ, TD, PTS, NC, draw), round and time, rounds scheduled.'
      operationId: getBoxingEventsById
      parameters:
      - description: Event ID
        in: path
        name: id
        required: true
        schema:
          type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/middleware.Response'
                - properties:
                    data:
                      $ref: '#/components/schemas/dto.BoxingEventResponse'
                  type: object
          description: OK
        '400':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/middleware.Response'
                - properties:
                    error:
                      $ref: '#/components/schemas/middleware.ErrorInfo'
                  type: object
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/middleware.Response'
                - properties:
                    error:
                      $ref: '#/components/schemas/middleware.ErrorInfo'
                  type: object
          description: Unauthorized
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '404':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/middleware.Response'
                - properties:
                    error:
                      $ref: '#/components/schemas/middleware.ErrorInfo'
                  type: object
          description: Not Found
      security:
      - ApiKeyAuth: []
      - BearerAuth: []
      - x402: []
      summary: Get a boxing event with its bouts
      tags:
      - boxing
      x-x402:
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        currency: USDC
        discovery: https://api.sportstatsapi.com/.well-known/x402
        minSinglePayment: '0.01'
        network: eip155:8453
        price: '0.005'
  /boxing/fighters:
    get:
      description: Fighters whose name contains q
      operationId: getBoxingFighters
      parameters:
      - description: Part of the name (2+ characters)
        in: query
        name: q
        required: true
        schema:
          type: string
      - description: Maximum results (1-100)
        in: query
        name: limit
        schema:
          default: 50
          type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/middleware.Response'
                - properties:
                    data:
                      items:
                        $ref: '#/components/schemas/dto.BoxingFighterHit'
                      type: array
                  type: object
          description: OK
        '400':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/middleware.Response'
                - properties:
                    error:
                      $ref: '#/components/schemas/middleware.ErrorInfo'
                  type: object
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/middleware.Response'
                - properties:
                    error:
                      $ref: '#/components/schemas/middleware.ErrorInfo'
                  type: object
          description: Unauthorized
        '500':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/middleware.Response'
                - properties:
                    error:
                      $ref: '#/components/schemas/middleware.ErrorInfo'
                  type: object
          description: Internal Server Error
      security:
      - ApiKeyAuth: []
      - BearerAuth: []
      summary: Find boxers
      tags:
      - boxing
  /boxing/fighters/{id}:
    get:
      description: Profile (Wikidata birth date and country; height, reach, stance and professional record from the article), world titles held now and the latest 20 stored bouts
      operationId: getBoxingFightersById
      parameters:
      - description: Fighter ID
        in: path
        name: id
        required: true
        schema:
          type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/middleware.Response'
                - properties:
                    data:
                      $ref: '#/components/schemas/dto.BoxingFighterResponse'
                  type: object
          description: OK
        '400':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/middleware.Response'
                - properties:
                    error:
                      $ref: '#/components/schemas/middleware.ErrorInfo'
                  type: object
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/middleware.Response'
                - properties:
                    error:
                      $ref: '#/components/schemas/middleware.ErrorInfo'
                  type: object
          description: Unauthorized
        '404':
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/middleware.Response'
                - properties:
                    error:
                      $ref: '#/components/schemas/middleware.ErrorInfo'
                  type: object
          description: Not Found
      security:
      - ApiKeyAuth: []
      - BearerAuth: []
      summary: Get a boxer
      tags:
      - boxing
components:
  schemas:
    dto.WikiPlayerRef:
      properties:
        id:
          type: integer
        name:
          type: string
      type: object
    dto.BoxingBoutResponse:
      properties:
        card:
          type: string
        date:
          type: string
        event:
          $ref: '#/components/schemas/dto.WikiTournamentRef'
        fighter1:
          $ref: '#/components/schemas/dto.WikiPlayerRef'
        fighter2:
          $ref: '#/components/schemas/dto.WikiPlayerRef'
        id:
          type: integer
        method:
          type: string
        result:
          type: string
        round:
          type: integer
        scheduled_rounds:
          type: integer
        time:
          type: string
        titles:
          items:
            type: string
          type: array
        weight_class:
          type: string
        winner:
          type: integer
      type: object
    dto.BoxingChampionLine:
      properties:
        body:
          type: string
        fighter:
          $ref: '#/components/schemas/dto.WikiPlayerRef'
        record:
          type: string
        sex:
          description: men, women
          type: string
        since:
          type: string
        status:
          type: string
        weight_class:
          type: string
      type: object
    middleware.Response:
      properties:
        data: {}
        error:
          $ref: '#/components/schemas/middleware.ErrorInfo'
        meta:
          $ref: '#/components/schemas/middleware.MetaInfo'
        success:
          type: boolean
      type: object
    dto.BoxingFighterResponse:
      properties:
        attribution:
          type: string
        bouts_recorded:
          type: integer
        id:
          type: integer
        name:
          type: string
        profile:
          $ref: '#/components/schemas/dto.BoxerData'
        recent_bouts:
          items:
            $ref: '#/components/schemas/dto.BoxingBoutResponse'
          type: array
        titles:
          items:
            $ref: '#/components/schemas/dto.BoxingChampionLine'
          type: array
        wikipedia_article:
          type: string
      type: object
    dto.BoxingChampionsResponse:
      properties:
        attribution:
          type: string
        champions:
          items:
            $ref: '#/components/schemas/dto.BoxingChampionLine'
          type: array
      type: object
    dto.BoxingFighterHit:
      properties:
        bouts:
          type: integer
        id:
          type: integer
        name:
          type: string
      type: object
    dto.BoxerData:
      properties:
        birth_date:
          type: string
        country:
          type: string
        height_cm:
          type: integer
        reach_cm:
          type: integer
        record:
          items:
            type: integer
          type: array
        stance:
          type: string
        wikidata_id:
          type: string
      type: object
    dto.WikiTournamentRef:
      properties:
        id:
          type: integer
        name:
          type: string
        season:
          type: string
      type: object
    dto.BoxingEventResponse:
      properties:
        attribution:
          type: string
        bouts:
          items:
            $ref: '#/components/schemas/dto.BoxingBoutResponse'
          type: array
        city:
          type: string
        date:
          type: string
        id:
          type: integer
        kind:
          type: string
        main_event_winner:
          $ref: '#/components/schemas/dto.WikiPlayerRef'
        name:
          type: string
        season:
          description: year
          type: string
        status:
          type: string
        updated_at:
          type: string
        venue:
          type: string
        wikipedia_article:
          type: string
      type: object
    middleware.MetaInfo:
      properties:
        attribution:
          description: Attribution a data source's licence asks for (Cricsheet's history).
          type: string
        has_more:
          description: 'HasMore: the cursor-paged list has more rows now (ask again at once).'
          type: boolean
        limit:
          type: integer
        live:
          description: 'Live: the answer is the live feed''s, kept while the match is played

            (cricket ball by ball before Cricsheet''s file replaces it).'
          type: boolean
        next_cursor:
          description: NextCursor continues a cursor-paged list (GET /changes).
          type: string
        offset:
          type: integer
        sources:
          description: 'Sources: where the answer''s data came from, with each source''s licence

            and the attribution it asks for (docs/source-licences.md).'
          items:
            $ref: '#/components/schemas/middleware.SourceInfo'
          type: array
        total:
          type: integer
        warnings:
          description: 'Warnings: query parameters ignored or changed (a limit above the

            maximum is clamped to it; a from/to that is not a date is ignored).'
          items:
            type: string
          type: array
      type: object
    middleware.ErrorInfo:
      properties:
        code:
          type: string
        message:
          type: string
      type: object
    middleware.SourceInfo:
      properties:
        attribution:
          description: show it with the data
          example: 'Data: nflverse (CC-BY 4.0)'
          type: string
        licence:
          description: the licence or terms the data is served under
          example: CC-BY-4.0
          type: string
        name:
          description: provider = our main licensed feed
          example: nflverse
          type: string
      type: object
  responses:
    PaymentRequired:
      content:
        application/json:
          schema:
            properties:
              accepts:
                items:
                  additionalProperties: true
                  type: object
                type: array
              error:
                type: string
              resource:
                properties:
                  mimeType:
                    type: string
                  url:
                    type: string
                type: object
              x402Version:
                example: 2
                type: integer
            required:
            - x402Version
            - accepts
            type: object
      description: 'Payment Required: no API key and no valid payment. The body and the PAYMENT-REQUIRED header (base64 JSON) carry the x402 offers; pay one and repeat the request with PAYMENT-SIGNATURE. Only a 200 answer is charged.'
      headers:
        PAYMENT-REQUIRED:
          description: Base64 JSON of the x402 offers
          schema:
            type: string
  securitySchemes:
    ApiKeyAuth:
      description: API key
      in: header
      name: X-API-Key
      type: apiKey
    BearerAuth:
      description: The same API key as a bearer token
      scheme: bearer
      type: http
    x402:
      description: x402 v2 payment (USDC on Base, eip155:8453) built from the offers of a 402 answer; see https://api.sportstatsapi.com/.well-known/x402
      in: header
      name: PAYMENT-SIGNATURE
      type: apiKey
externalDocs:
  description: x402 payment offers and prices
  url: https://api.sportstatsapi.com/.well-known/x402