---
title: "GET /predictions"
method: GET
path: "/predictions"
---

# GET /predictions

`GET /predictions`

## Query parameters

- `nextToken` string
- `maxResults` string
- `sortBy` string
- `order` string
- `modelId` string

## Response `200`

200 response

- Predictions
  - `modelId` string
  - `nextToken` string, nullable, required
  - `order` 'ascending' | 'descending'
  - `predictions` object[], required
    - `createdBy` string, nullable
    - `createdTime` string, nullable
    - `documentId` string, required
    - `error` string, nullable
    - `inferenceTime` number, nullable
    - `modelId` string, required
    - `nextPage` integer, nullable
    - `postprocessConfig` union
      - object
        - `outputFormat` 'v1' | 'v2'
        - `strategy` 'BEST_FIRST', required
      - object
        - `outputFormat` 'v1' | 'v2'
        - `parameters` object, required
          - `collapse` boolean
          - `n` integer, required
        - `strategy` 'BEST_N_PAGES', required
    - `predictionId` string, required
    - `predictions` union, required
      - union[], nullable
        - union
          - object
            - `confidence` number, required
            - `label` string, required
            - `location` number[]
            - `page` integer
            - `rawValue` string, nullable
            - `source` 'llm' | 'model'
            - `value` string, nullable, required
          - object
            - `label` string, required
            - `page` integer
            - `value` array[], required
              - …
      - object, nullable
    - `preprocessConfig` object, nullable
      - `autoRotate` boolean
      - `imageQuality` 'LOW' | 'HIGH'
      - `maxPages` integer
      - `pages` integer[]
      - `rotation` 0 | 90 | 180 | 270
      - `startPage` integer
    - `status` 'pending' | 'succeeded' | 'failed'
    - `trainingId` string, nullable
  - `sortBy` 'createdTime'

## Other responses

- `400` — 400 response
- `403` — 403 response
- `404` — 404 response
- `415` — 415 response
- `500` — 500 response

## Changes

- **2026-07-13** `d5fe190026be` — 4 breaking, 5 info
  - the response property `predictions/items/inferenceTime` became nullable for the status `200`
  - the response property `predictions/items/inferenceTime` became optional for the status `200`
  - the `predictions/items/postprocessConfig/oneOf[subschema #2]/parameters/n` response property's max was increased from `3.00` to `100.00` for the response status `200`
  - the `predictions/items/preprocessConfig/maxPages` response property's max was increased from `3.00` to `100.00` for the response status `200`
  - …5 more
- **2024-02-05** `c371d93c085f` — 4 info
  - added the optional property `predictions/items/nextPage` to the response with the `200` status
  - added the optional property `predictions/items/preprocessConfig/startPage` to the response with the `200` status
  - added `subschema #1, subschema #2` to the `predictions/items/predictions/anyOf[subschema #1]/items/` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `predictions/items/predictions/anyOf[subschema #1]/items/` response property `anyOf` list for the response status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/lucidtechai/apis/lucidtech-api/changes/predictions/get.md)

---

[API](https://skmtc.dev/lucidtechai/apis/lucidtech-api.md) · [All operations](https://skmtc.dev/lucidtechai/apis/lucidtech-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lucidtechai/lucidtech-api/revisions/d5fe190026be/schema)