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

# GET /documents

`GET /documents`

## Query parameters

- `datasetId` string
- `nextToken` string
- `order` string
- `documentId` string
- `consentId` string
- `maxResults` string
- `sortBy` string

## Response `200`

200 response

- Documents
  - `consentId` string[]
  - `datasetId` string[]
  - `documents` object[], required
    - `consentId` string
    - `content` string
    - `contentMD5` string, nullable, required
    - `contentType` 'application/pdf' | 'image/jpeg' | 'image/png' | 'image/tiff', required
    - `createdBy` string, nullable, required
    - `createdTime` string, nullable, required
    - `datasetId` string
    - `description` string, nullable, required
    - `documentId` string, required
    - `groundTruth` object[]
      - `label` string, required
      - `value` union, required
        - string, nullable
        - boolean, nullable
        - number, nullable
        - union
          - object[]
            - `label` string, required
            - `value` union, required
              - …
          - array[]
            - object[]
              - …
    - `metadata` object, nullable, required
    - `name` string, nullable, required
    - `retentionInDays` integer, required
    - `updatedBy` string, nullable, required
    - `updatedTime` string, nullable, required
  - `nextToken` string, nullable, required
  - `order` 'ascending' | 'descending'
  - `sortBy` 'createdTime'

## Other responses

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

## Changes

- **2022-09-29** `424af607ab69` — 2 breaking, 2 info
  - the response property `documents/items/groundTruth/items/value/anyOf[#/components/schemas/groundTruthList]/` became nullable for the status `200`
  - the response property `documents/items/metadata` became nullable for the status `200`
  - added `subschema #2, subschema #3` to the `documents/items/groundTruth/items/value` response property `anyOf` list for the response status `200`
  - removed `subschema #2, subschema #3` from the `documents/items/groundTruth/items/value` response property `anyOf` list for the response status `200`
- **2022-09-15** `7d1a75b4f88a` — 1 info
  - added the new optional `query` request parameter `documentId`
- **2022-09-13** `b8d771f64c04` — 1 info
  - added the required property `documents/items/contentMD5` to the response with the `200` status
- **2022-04-12** `8e2223658454` — 4 info
  - added the new optional `query` request parameter `order`
  - added the new optional `query` request parameter `sortBy`
  - added the optional property `order` to the response with the `200` status
  - added the optional property `sortBy` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/lucidtechai/apis/lucidtech-api/changes/documents/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/424af607ab69/schema)