---
title: "Get file upload requests by user token"
method: GET
path: "/payout/file_uploads/{user_token}"
tags: ["KYC"]
---

# Get file upload requests by user token

`GET /payout/file_uploads/{user_token}`

This **GET** endpoint retrieves the list of file upload requests associated with a specific user.  
<br> You must provide the `user_token` in the URL path to identify the user.  
<br> Each file upload request includes the `file_upload_token`, the types of files accepted (`files_types_accepted`), the time when the request was created, and whether the request is required to proceed with payouts.  
<br> The response also includes any referenced attributes (`ref_attributes`) that link the file request to specific data, such as bank account details or other identifiers.  
<br> You can use the optional query parameter `only_required` to filter results and return only those file upload requests that are mandatory.  
<br> The response will be an array of file upload requests, which can then be used to determine what documents need to be uploaded by the user.

## Query parameters

- `only_required` boolean
- `only_incomplete` boolean

## Response `200`

OK

- FileUploadResp[]
  - `file_upload_token` string, required — File upload request token. Need to reference this token when uploading files.
  - `files_types_accepted` string[], required — Types of files that can be accepted
  - `time_of_request` string, date-time, required — Date and time the file upload request was created
  - `is_required` boolean, required — Indication whether this file upload is required in order to initiate payouts
  - `ref_attributes` object, required — An object with referenced attributes that this document collection is related to. For example, it may contain the bank account and bank routing numbers for which we require a bank statement.
  - `is_completed` boolean, required — Indicate whether the file request was completed
  - `time_completed` string, date-time — If completed, the date and time when it was completed
  - `is_verified` boolean, required — Indicate wether the file request was verified and is considered completed
  - `note` string — Optional note that will provide additional context about the file upload request
  - `file_upload_link` string — If the request has not yet been completed, this field contains a URL where the user can upload the required files.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — You do not have necessary permissions for the resource
- `404` — Not Found
- `405` — Invalid input
- `500` — Internal Server Error
- `504` — Gateway Timeout

---

[API](https://skmtc.net/masspay/apis/masspay-api.md) · [All operations](https://skmtc.net/masspay/apis/masspay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/masspay/masspay-api/versions/c03b61a6a551/schema)