---
title: "Search archive files your key can download"
method: GET
path: "/v1/files"
tags: ["data"]
---

# Search archive files your key can download

`GET /v1/files`

## Request

- Base URL: `https://outcometick.com`
- URL: `https://outcometick.com/v1/files`
- Auth: HTTP bearer

Every filter is optional and takes a comma-separated list. asset is the BASE symbol (BTC, not BTCUSD — an unknown value matches nothing). interval=5m excludes the period-less settlement streams; use interval=5m,none for both. Without date/from/to it lists the newest day in reach.

## Query parameters

- `date` string, date: UTC day, YYYY-MM-DD
- `from` string, date: UTC day, YYYY-MM-DD
- `to` string, date: UTC day, YYYY-MM-DD
- `venue` string
- `dataset` string
- `asset` string
- `interval` string
- `format` 'gz' | 'parquet'

## Response `200`

OK

- object
  - `from` string, date: UTC day, YYYY-MM-DD
  - `to` string, date: UTC day, YYYY-MM-DD
  - `days` integer
  - `format` string
  - `count` integer
  - `pending` integer: Parquet only: matching files not converted yet
  - `bytes` integer
  - `files` ApiFile[]
    - `date` string, date: UTC day, YYYY-MM-DD
    - `name` string
    - `venue` string
    - `dataset` string
    - `asset` string, nullable
    - `interval` string, nullable
    - `bytes` integer
    - `sha256` string
    - `rows` integer: Parquet listings only
    - `source` string: Parquet listings only: the archive file it was converted from
    - `url` string, uri: One-step download (GET /v1/dl/{date}/{name})

## Other responses

- `400`: Bad date, range too large, or bad format
- `401`: Missing, unknown, revoked or expired key
- `403`: Outside your coverage window
- `429`: Rate limited; retry after the Retry-After header
- `503`: Temporarily unavailable; retry

---

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