# Datasets_GetCameraLags

`GET /v1/accounts/{account}/datasets/{dataset}/cameraLags`

Reads per-camera lag estimates and current stamp offsets for an upload,
or every upload held by a merged dataset. Untrusted estimates are reported
but never applied implicitly.

- Base URL: `https://junction-api.qualiastudios.dev`
- Authentication: an API key in the `X-API-Key` header

## Parameters

- `account` (path, string, required): The account id.
- `dataset` (path, string, required): The dataset id.

## Responses

- `200` OK: `application/json` `qualia.v1.CameraLags`
- `default` Default error response: `application/json` `google.rpc.Status`

## Schemas

```yaml
qualia.v1.CameraLags:
  type: object
  properties:
    name:
      type: string
      description: The camera lag view for the dataset requested.
    cameras:
      readOnly: true
      type: array
      items:
        $ref: "#/components/schemas/qualia.v1.DatasetCameraLag"
      description: Entries are grouped by upload; merged dataset topics are member-local.
  description: The per-camera lag estimates and the current setting for each topic.
qualia.v1.DatasetCameraLag:
  type: object
  properties:
    upload:
      readOnly: true
      type: string
      description: The upload containing this camera.
    topic:
      readOnly: true
      type: string
      description: Camera topic in this upload.
    estimatedLagMs:
      readOnly: true
      type: number
      description: |-
        Median trusted per-episode lag; positive means camera content is late.
        Unset if no trusted estimate exists.
      format: double
    confidence:
      readOnly: true
      type: number
      description: Median confidence among trusted estimates.
      format: double
    sampleCount:
      readOnly: true
      type: integer
      description: Episodes with a stored lag entry for this camera.
      format: int32
    trustedSampleCount:
      readOnly: true
      type: integer
      description: Episodes with a trusted, finite lag and confidence.
      format: int32
    appliedOffsetMs:
      readOnly: true
      type: number
      description: Published channel stamp_offset_ms; unset means ingest uses zero.
      format: double
    estimateApplicable:
      readOnly: true
      type: boolean
      description: Whether the stored estimate can safely determine an absolute offset.
    estimateUnavailableReason:
      readOnly: true
      type: string
      description: Why the estimate cannot be applied; empty when it can be applied.
    topicAvailable:
      readOnly: true
      type: boolean
      description: Whether the ingest report proved this camera's native topic mapping.
    source:
      readOnly: true
      type: string
      description: "Provenance aggregated from stored per-episode values: recorded, estimated, mixed, or unknown."
    method:
      readOnly: true
      type: string
      description: Stored estimator/event method, mixed when multiple methods were recorded.
  description: One camera topic's aggregate lag and current correction.
google.rpc.Status:
  oneOf:
    - $ref: "#/components/schemas/ApiError"
    - $ref: "#/components/schemas/GatewayError"
  description: "The body of a failed call: one of the two shapes below."
ApiError:
  title: API error
  type: object
  required:
    - code
    - message
    - retryable
    - details
  properties:
    code:
      type: string
      description: The gRPC code name in upper case, e.g. `NOT_FOUND`.
    message:
      type: string
    retryable:
      type: boolean
      description: Whether the same call may succeed if retried.
    details:
      type: array
      items:
        type: object
      description: "Empty, except when a dataset copy or move is refused: then one `google.rpc.ErrorInfo` with the refusal's `reason` code, its `domain` and, in `metadata`, the datasets it names."
  description: A refusal from the API itself.
GatewayError:
  title: Gateway error
  type: object
  required:
    - detail
  properties:
    detail:
      type: string
      description: What went wrong.
  description: A refusal from the gateway before the call reaches the API, for example `401` bad or missing API key, `403` key lacks the scope or environment closed, `413` body too large.
```