---
sourceType: api-reference
sourceTypeMatchedRule: openApis
slug: MA/openApis/partner/kyb/getDocuments
title: Lấy danh sách giấy tờ đã nộp
---
Được sử dụng để lấy danh sách tất cả các giấy tờ đã nộp và trạng thái xét duyệt của chúng.

### Parameters

| Property  | Type | Required | Description     |
| --------- | ---- | -------- | --------------- |
| miniAppId | Long | true     | ID của Mini App |

### Return Values

| Property | Type   | Description                                              |
| -------- | ------ | -------------------------------------------------------- |
| error    | int    | Mã lỗi của kết quả trả về, bằng 0 nếu request thành công |
| message  | String | Lời nhắn chi tiết tương ứng với mã lỗi                   |
| data     | Object | Dữ liệu giấy tờ                                          |

#### Data Object

| Property           | Type                 | Description                               |
| ------------------ | -------------------- | ----------------------------------------- |
| businessStatus     | String               | Trạng thái chung của giấy tờ doanh nghiệp |
| ownerRequests      | List<Document> | Danh sách giấy tờ cá nhân                 |
| businessRequests   | List<Document> | Danh sách giấy tờ doanh nghiệp            |
| additionalRequests | List<Document> | Danh sách giấy tờ bổ sung                 |

#### Document

| Property      | Type                     | Description           |
| ------------- | ------------------------ | --------------------- |
| id            | Long                     | ID của request        |
| reviewStatus  | String                   | Trạng thái xét duyệt  |
| ownerId       | String                   | ID của chủ sở hữu     |
| createdAt     | Long                     | Thời gian tạo         |
| documentFiles | List<DocumentFile> | Danh sách tệp giấy tờ |

#### DocumentFile

| Property       | Type    | Description          |
| -------------- | ------- | -------------------- |
| name           | String  | Tên tệp              |
| url            | String  | URL của tệp          |
| documentType   | String  | Tên loại giấy tờ     |
| documentTypeId | Integer | ID loại giấy tờ      |
| subCategoryId  | Integer | ID danh mục con      |
| new            | boolean | Đánh dấu giấy tờ mới |

#### Sample Code


### Code sample — Java

```js
import java.util.List;

import com.vng.zalo.miniapp.openapi.sdk.models.documents.request.DocumentsRequest;
import com.vng.zalo.miniapp.openapi.sdk.models.documents.response.DocumentsResponse;

DocumentsRequest request = new DocumentsRequest();
request.setMiniAppId(YOUR_MINI_APP_ID);

DocumentsResponse response = client.getDocuments(request);

// Trạng thái chung của giấy tờ doanh nghiệp
String businessStatus = response.getData().getBusinessStatus();

// Lấy danh sách giấy tờ cá nhân
List<DocumentsResponse.Document> ownerDocs = response.getData().getOwnerRequests();

// Lấy danh sách giấy tờ doanh nghiệp
List<DocumentsResponse.Document> businessDocs = response.getData().getBusinessRequests();

// Lấy danh sách giấy tờ bổ sung
List<DocumentsResponse.Document> additionalDocs = response.getData().getAdditionalRequests();
```

### Code sample — Node.js

```js
const {
  error,
  message,
  businessStatus,
  ownerRequests,
  businessRequests,
  additionalRequests,
} = await client.getDocumentRequest({
  miniAppId: YOUR_MINI_APP_ID,
});

if (error === 0) {
  // handle ownerRequests, businessRequests, additionalRequests
}
```