# Read one dataset's bounded structured ingest report

`GET /v1/datasets/ingest-report`

Read only ``meta/ingest_report.json`` under the server's 8 MiB cap.

This metadata endpoint has no caller-controlled file parameter; bulk
payloads use direct object-storage capabilities. ``ref`` lets an uploader pin the read to
the commit its own publication created, since the branch tip may already
carry a concurrent re-upload's findings.

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

## Parameters

- `path` (query, string, required): Dataset path (org/name)

  ```yaml
  type: string
  maxLength: 300
  ```
- `ref` (query, string | null): Branch / tag / commit (default main)

  ```yaml
  maxLength: 120
  type:
    - string
    - "null"
  ```

## Responses

- `200` Structured report or an explicit omission reason: `application/json` `any`
- `401` Invalid or missing API key: `application/json` `ErrorResponse`
- `404` The canonical ingest report does not exist
- `422` Validation Error: `application/json` `HTTPValidationError`

## Schemas

```yaml
ErrorResponse:
  properties:
    detail:
      type: string
      description: Error message describing what went wrong
  type: object
  required:
    - detail
  title: ErrorResponse
  description: Standard error response.
HTTPValidationError:
  properties:
    detail:
      items:
        $ref: "#/components/schemas/ValidationError"
      type: array
  type: object
  title: HTTPValidationError
ValidationError:
  properties:
    loc:
      items:
        type:
          - string
          - integer
      type: array
      title: Location
    msg:
      type: string
      title: Message
    type:
      type: string
      title: Error Type
    input: {}
    ctx:
      type: object
      title: Context
  type: object
  required:
    - loc
    - msg
    - type
  title: ValidationError
```