stat-api-com Reference API

openapi: 3.2.0
info:
  title: Stat Api Com Reference API
  version: 1.0.0
  description: 'Operations tagged Reference across 2 of this provider''s published API definitions: public.json, stat-api-com-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- description: Production
  url: https://api.stat-api.com
- description: Local dev
  url: http://localhost:3000
security:
- BearerAuth: []
tags:
- description: Read-only catalog of Reference tables.
  name: Reference
paths:
  /api/v1/reference/operators:
    get:
      operationId: list_reference_operators
      parameters:
      - description: Page size; defaults to (and is capped at) 5000.
        in: query
        name: limit
        schema:
          default: 5000
          maximum: 5000
          minimum: 1
          type: integer
      - description: Return rows with `id` strictly greater than this value, in ascending id order. To walk every row, start at 0 and then pass the previous response's `next_from_id`. Without it, the first page uses the table's default sort and returns no cursor.
        in: query
        name: from_id
        schema:
          minimum: 0
          type: integer
      - description: 'Response format: `json` (default) or `csv` — the same rows as CSV with raw values, a blank cell for null, and `X-Next-From-Id` when another page exists. With `format=csv` only, the API key may be passed as the `key` query param (for Google Sheets IMPORTDATA); use a separate, revocable key for that.'
        in: query
        name: format
        schema:
          enum:
          - json
          - csv
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReferenceOperatorsListResponse'
            text/csv:
              schema:
                type: string
          description: operators rows matching the declared filter set.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MissingRequiredFiltersError'
          description: No declared filter set was satisfied by the request — see `accepted` in the body for the valid combinations.
      summary: List operators for Reference
      tags:
      - Reference
    servers:
    - description: Production
      url: https://api.stat-api.com
    - description: Local dev
      url: http://localhost:3000
  /api/v1/reference/operators/{id}:
    get:
      operationId: get_reference_operators_by_id
      parameters:
      - description: Primary key (id) of the operators row.
        in: path
        name: id
        required: true
        schema:
          description: Primary Key
          format: int64
          type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReferenceOperators'
          description: Single operators row.
        '404':
          description: Row not found.
      summary: Get a single operator by id
      tags:
      - Reference
    servers:
    - description: Production
      url: https://api.stat-api.com
    - description: Local dev
      url: http://localhost:3000
components:
  schemas:
    ReferenceOperators:
      description: The operators referenced by every operator_id filter across the public API — DFS sites (1 DraftKings, 2 FanDuel, 3 Yahoo), sportsbooks (1683 Pinnacle, 1684 BetMGM, 1685 Caesars, 1686 BetRivers, 1687 ESPN BET), the betting consensus (6 Consensus), and the other sources of the data. A small read-only lookup table.
      properties:
        code:
          description: Stable machine code (e.g. draftkings, fanduel, consensus, pinnacle).
          type: string
        description:
          type:
          - string
          - 'null'
        id:
          description: Primary Key
          format: int64
          type: integer
        is_active:
          description: False for operators no longer ingested.
          type: boolean
        name:
          description: Display name (e.g. DraftKings, FanDuel, Pinnacle).
          type: string
        operator_type:
          description: Operator class — DFS, betting, media, or data provider (mixed-case legacy values exist).
          type: string
        website_url:
          type:
          - string
          - 'null'
      required:
      - id
      - code
      - is_active
      - name
      - operator_type
      type: object
    MissingRequiredFiltersError:
      description: Returned when a list endpoint in the required-filter-set regime receives no query that satisfies any declared set. `accepted` enumerates the valid filter combinations; pick one and resend.
      properties:
        accepted:
          description: Each inner array is one declared filter set; satisfy every name in any one set to get a 200.
          items:
            items:
              type: string
            type: array
          type: array
        error:
          description: Stable error code for programmatic dispatch.
          enum:
          - missing_required_filters
          type: string
      required:
      - error
      - accepted
      type: object
    ReferenceOperatorsListResponse:
      properties:
        has_more:
          description: True when a full page came back, so more rows can exist.
          type: boolean
        limit:
          description: Page size used for this response.
          type: integer
        next_from_id:
          description: 'Pass this as `from_id` on the next request to page forward. `null` on the terminal page, and on a first page requested without `from_id` (that page uses the default sort): to walk every row, start with `from_id=0`.'
          type:
          - integer
          - 'null'
        operators:
          items:
            $ref: '#/components/schemas/ReferenceOperators'
          type: array
      required:
      - operators
      - limit
      - next_from_id
      - has_more
      type: object
  securitySchemes:
    BearerAuth:
      bearerFormat: API key
      description: 'Pass your API key as an Authorization header: `Authorization: Bearer YOUR_API_KEY` (the `ApiKey` scheme is accepted as an alias). The docs UI exposes a global API key field that substitutes into every code sample and live request. Unauthenticated requests to /api/v1 are rejected with 401 — every call needs a key (the shared trial key works only against each endpoint''s documented default URL).'
      scheme: bearer
      type: http
x-refined-from:
- public.json
- stat-api-com-openapi.json