---
title: "Ingest Blackbox"
method: POST
path: "/api/picks/blackbox/ingest"
tags: ["picks"]
---

# Ingest Blackbox

`POST /api/picks/blackbox/ingest`

## Request

- Base URL: `https://api.fairline.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.fairline.io/api/picks/blackbox/ingest`
- Auth: HTTP bearer

## Request body

- IngestRequest
  - `slate_date` string, date, required
  - `sport` string
  - `snapshot_hash` string, required
  - `model_version` string, required
  - `n_judges` integer, nullable
  - `candidates` CandidateIn[], required
    - `line_id` string, required
    - `external_game_id` string, required
    - `market` string, required
    - `selection` string, required
    - `scores` JudgeScore[]
      - `judge_index` integer, required
      - `probability` number, nullable
      - `bet` boolean
      - `reasoning` string, nullable
      - `expected_bf` number, nullable
      - `k_pct_adj` number, nullable
      - `expected_home_runs` number, nullable
      - `expected_away_runs` number, nullable
    - `news_sources` object[]

## Response `200`

Successful Response

- IngestResponse
  - `snapshot_id` integer, required
  - `created` integer, required
  - `already_committed` boolean, required
  - `picks` BlackboxPickOut[], required
    - `id` integer, required
    - `sport` string, required
    - `game_date` string, date, required
    - `external_game_id` string, required
    - `home_team` string, nullable
    - `away_team` string, nullable
    - `game_time_utc` string, date-time, nullable
    - `market` string, required
    - `side` string, required
    - `line` number, nullable
    - `bookmaker` string, required
    - `odds_taken_decimal` number, required
    - `model_probability` number, required
    - `market_fair_probability` number, nullable
    - `edge` number, required
    - `confidence_tier` string, required
    - `consensus_votes` string, required
    - `display_units` number, required
    - `reasoning` string, nullable
    - `news_sources` object[], nullable
    - `model_version` string, required
    - `generated_at` string, date-time, required
    - `result` string, nullable
    - `pnl` number, nullable
    - `voided_at` string, date-time, nullable
    - `void_reason` string, nullable
    - `clv_pct` number, nullable
    - `clv_status` string
    - `beat_close` boolean, nullable
    - `closing_decimal` number, nullable
    - `clv_pct_novig` number, nullable
    - `beat_close_novig` boolean, nullable
    - `clv_close_source_novig` string, nullable
    - `closing_fair_decimal_novig` number, nullable
    - `dissent_reasoning` string, nullable

## Other responses

- `422`: Validation Error

---

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