---
title: "GET /history/files"
method: GET
path: "/history/files"
tags: ["History"]
---

# GET /history/files

`GET /history/files`

## Request

- Base URL: `https://api.sockodds.com/v1`
- URL: `https://api.sockodds.com/v1/history/files`
- Auth: HTTP bearer

Pro and Internal only. Whole days of history as Parquet files, one file per league and UTC day, from 22 December 2025 up to two days ago. Each file holds the rows /v1/odds/history returns for that league and day, sorted by event and observation time. Own observations only. Listing bills one object per file listed.

## Query parameters

- `league` string
- `cursor` string
- `limit` integer

## Response `200`

History day files

- HistoryFilesEnvelope
  - `data` HistoryFile[], required
    - `league` NamedKey, required
      - `key` string, required
      - `name` string, required
    - `day` string, date, required
    - `rows` integer, required
    - `bytes` integer, required
    - `sha256` string, required
    - `observed_from` string, date-time, required
    - `observed_to` string, date-time, required
    - `url` string, uri, required
  - `meta` Meta, required
    - `count` integer, required
    - `cursor` string, nullable, required
  - `links` Links, required
    - `next` string, uri-reference, nullable, required

## Other responses

- `default`: Request failed

---

[API](https://skmtc.dev/sockodds/apis/sockodds-api.md) · [All operations](https://skmtc.dev/sockodds/apis/sockodds-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sockodds/apis/sockodds-api/revisions/f4c680d355be?raw)