---
title: "Ingest a Marshal launch-monitor capture session"
method: POST
path: "/v1/sessions/ingest"
---

# Ingest a Marshal launch-monitor capture session

`POST /v1/sessions/ingest`

## Request

- Base URL: `https://api.eldrick.com`
- URL: `https://api.eldrick.com/v1/sessions/ingest`
- Auth: HTTP bearer

Stores a batch-captured launch-monitor session without consuming fitting-analysis quota. Re-posting the same sessionId replaces the stored payload.

## Request body

- SessionIngestRequest
  - `payloadVersion` integer, required
  - `appVersion` string, required
  - `customerRef` string: Optional customer email or web-app customer id.
  - `sessionId` string, uuid, required
  - `fitterId` string, required
  - `startedAtUtc` string, date-time, required
  - `processedAtUtc` string, date-time, required
  - `segments` SessionSegment[], required
    - `id` string, uuid, required
    - `label` string, nullable
    - `shots` SessionShot[], required
      - `shotId` string, uuid, required
      - `shotNumber` integer, required
      - `capturedAtUtc` string, date-time, required
      - `club` string, nullable
      - `source` 'ocr-foresight' | 'ocr-trackman' | 'synthetic' | 'csv', required
      - `measurementRef` 'club-face' | 'club-cog', required
      - `units` string, required
      - `ocrConfidence` number, nullable
      - `needsReview` boolean, required
      - `ball` NullableMetricBag, nullable
      - `club_` NullableMetricBag, nullable
      - `extended` NullableMetricBag, nullable

## Response `200`

Existing session replaced idempotently

- SessionIngestResponse
  - `sessionUrl` string, uri, required
  - `customerMatched` boolean, required
  - `shotsAccepted` integer, required

## Other responses

- `201`: Session created
- `400`: Validation error
- `401`: Unauthorized
- `426`: Payload version no longer supported
- `429`: Rate limited

---

[API](https://skmtc.dev/eldrick/apis/eldrick-golf-fitting-api.md) · [All operations](https://skmtc.dev/eldrick/apis/eldrick-golf-fitting-api/llms.txt) · [OpenAPI document](https://skmtc.dev/eldrick/apis/eldrick-golf-fitting-api/revisions/9469c1821a83?raw)