---
title: "List Documents"
method: GET
path: "/documents"
tags: ["Documents"]
---

# List Documents

`GET /documents`

List the user's documents from employment data sources.

## Query parameters

- `size` integer
- `cursor` string
- `userId` string
- `accountId` string
- `sourceId` string

## Response `200`

OK

- DocumentListResponse
  - `code` 'OK' | 'CREATED' | 'INVALID_CREDENTIALS' | 'INVALID_PARAMETERS' | 'INVALID_TOKEN' | 'UNAUTHORIZED_ACCESS' | 'MISSING_RESOURCE' | 'REQUEST_LIMIT_EXCEEDED' | 'SERVER_ERROR' | 'UNSUPPORTED_METHOD' | 'SERVER_UNAVAILABLE' | 'TIME_LIMIT_EXCEEDED' — Request status code
  - `message` string — Message response to the request
  - `requestId` string — Unique ID that is added to the body of every response for easy traceability of the request in our logs.
  - `data` DocumentListData
    - `nextCursor` string — The next cursor value that can be used in the following query.
    - `items` Document[]
      - `id` string, required — Unique ID of this object
      - `name` string, required — Document name
      - `docId` string, nullable — Document number
      - `status` string, nullable — Document status，only for NBI verification, It's VALID if the NBI verification status is valid.
      - `documentType` 'IDENTIFICATION' | 'PAYSLIP' | 'CLEARANCE' | 'CERTIFICATE' — Document Type
      - `issueDate` string, date, nullable — Issue date
      - `expiryDate` string, date, nullable — Expiry date
      - `fileUrl` string, nullable — Publicly available URL reference for the document
      - `remarks` string, nullable — Remarks section
      - `metadata` ObjectReferenceMetadata, required — Metadata related to account-specific data
        - `itemCreatedAt` string, date-time, required — Date and time
        - `createdAt` string, date-time, required — Date and time
        - `accountId` string — The accountId of this object
        - `sourceId` string, required — The ACCOUNT or ARCHIVE ID associated with this object
        - `sourceType` 'ACCOUNT' | 'UPLOAD' | 'ARCHIVE' | 'SOCIAL_SECURITY', nullable, required — Source Type
        - `userId` string, required — The user ID associated with this object
        - `providerId` string, required — The provider ID associated with this object

## Changes

- **2026-07-15** (v1) `3bcbeecafbab` — 10 info
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `404`
  - …6 more
- **2025-07-14** (v1) `2e8500e069bb` — 1 warning
  - added the new `SOCIAL_SECURITY` enum value to the `data/items/items/allOf[subschema #2]/metadata/sourceType` response property for the response status `200`
- **2024-06-27** (v1) `4f4b86b82632` — 1 breaking
  - the response property `data/items/items/allOf[subschema #2]/metadata/sourceType` became nullable for the status `200`

[Change history](https://skmtc.dev/smileapi/apis/smile-api/changes/documents/get.md)

---

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