> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wepayout.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Submit Document For KYC
> Submit documents for a pending KYC verification
# Submit Document For KYC
This route is used to submit documents for a pending KYC. There are two types of documents that can be submitted:
* **Text-type documents**
* **File-type documents**
Only one document can be updated at a time.
**Attention point**: Supported extensions for file-type documents: `jpg`, `jpeg`, `gif`, `png` and `pdf`
## Path Parameters
The ID of the document to update
## Body
The value to submit for the document. For file-type documents, provide the file URL. For text-type documents, provide the text value.
## Response
Unique identifier for the uploaded document record.
Identifier of the current validation status of the document.
Name of the document's validation status.
Identifier of the document.
Name of the document type uploaded.
Name of the document collection or group.
Identifier of the document collection.
URL for downloading the uploaded document file.
Reason for rejection if the document was not approved.
Label or description used to identify the document field.
Type of input expected for this field.
Example: `file` or `text`
Indicates whether this field is mandatory for completing the KYC process.
Expiration date of the document, if applicable.
Format: ``
Indicates whether the document is eligible for automatic validation.
Example: `1` = yes, `0` = no
## Request Example
```bash cURL theme={null}
curl --request POST \
--url https://api.sandbox.wepayout.com.br/v1/kyc/documents/{documentId}/update \
--header 'Accept: application/json' \
--header 'Authorization: Bearer 123' \
--header 'Content-Type: application/json' \
--data '{
"value": "string"
}'
```
```javascript JavaScript theme={null}
async function submitKYCDocument(documentId, value) {
const response = await fetch(
`https://api.sandbox.wepayout.com.br/v1/kyc/documents/${documentId}/update`,
{
method: 'POST',
headers: {
'Accept': 'application/json',
'Authorization': 'Bearer 123',
'Content-Type': 'application/json'
},
body: JSON.stringify({
value: value
})
}
);
if (!response.ok) {
throw new Error(`Failed to submit document: ${response.statusText}`);
}
return await response.json();
}
// Usage - Submit file URL
const fileResult = await submitKYCDocument(35, 'https://s3.amazonaws.com/bucket/file.pdf');
console.log('File document submitted:', fileResult);
// Usage - Submit text value
const textResult = await submitKYCDocument(36, 'John Doe');
console.log('Text document submitted:', textResult);
```
```python Python theme={null}
import requests
def submit_kyc_document(document_id, value):
url = f'https://api.sandbox.wepayout.com.br/v1/kyc/documents/{document_id}/update'
headers = {
'Accept': 'application/json',
'Authorization': 'Bearer 123',
'Content-Type': 'application/json'
}
data = {
'value': value
}
response = requests.post(url, headers=headers, json=data)
response.raise_for_status()
return response.json()
# Usage - Submit file URL
file_result = submit_kyc_document(35, 'https://s3.amazonaws.com/bucket/file.pdf')
print('File document submitted:', file_result)
# Usage - Submit text value
text_result = submit_kyc_document(36, 'John Doe')
print('Text document submitted:', text_result)
```
```json 200 OK theme={null}
{
"id": 5891,
"status_id": 2,
"status_name": "Waiting Approval Documents",
"document_id": 35,
"document_name": "kyc/qsa",
"collection_name": null,
"collection_id": null,
"value_field": "https://s3.amazonaws.com/bucket-name/path/to/file",
"rejection_reason": null,
"label": "KYC/QSA",
"type_field": "file",
"required_field": true,
"expires_at": null,
"automaticatic_validation": 0
}
```
## Best Practices
**One Document at a Time**: Only one document can be updated per request. To submit multiple documents, make separate API calls for each.
**File Extensions**: Ensure file-type documents use only supported extensions: `jpg`, `jpeg`, `gif`, `png`, or `pdf`.
**Document Status**: After submission, the document status will typically change to "Waiting Approval Documents" (status\_id: 2).
## Related Resources
List all KYC verifications
Get KYC by ID
Get KYC by document number
Create a payout payment