---
title: "Get file upload request details"
method: GET
path: "/payout/file_uploads/{user_token}/{file_upload_token}"
tags: ["KYC"]
---

# Get file upload request details

`GET /payout/file_uploads/{user_token}/{file_upload_token}`

This **GET** endpoint is used to get file upload request details.  
<br> You must specify both the `user_token` and the `file_upload_token` in the URL path to identify which user and file upload request to get details for.  
<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> The response will be a json object with the details of file upload request, which can then be used to determine what documents need to be uploaded by the user.

## 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/revisions/c03b61a6a551/schema)