---
id: "en/api-get-nd-api-file-file-logs"
title: "file log"
language: "en"
description: "GET /nd/api/file/file_logs: File log interface description, including path, method, parameters and return information."
canonical_url: "https://www.babel.cc/public/babelwiki/en/api-get-nd-api-file-file-logs.html"
markdown_url: "https://www.babel.cc/public/babelwiki/ai/en/api-get-nd-api-file-file-logs.md"
alternates: {"en": "https://www.babel.cc/public/babelwiki/ai/en/api-get-nd-api-file-file-logs.md", "zh": "https://www.babel.cc/public/babelwiki/ai/zh/api-get-nd-api-file-file-logs.md"}
reading_note: "文档记录不等于当前部署能力；以实际版本、授权模块与配置为准。保留原文的可选、限制及待确认说明，勿补猜接口。 / Documentation is not a guarantee for every deployment. Preserve optional-module requirements, limitations and unresolved API contracts."
---

# File log

| Properties | Values |
| --- | --- |
| HTTP methods | `GET` |
| Interface path | `/nd/api/file/file_logs` |
| Category | File API |

## Interface description

Interface path: `/nd/api/file/file_logs`

HTTP method: `GET`


**HTTP method:** `GET`

#### URL query parameters

| Parameter | Type | Description (source requirements, defaults and scope) |
| --- | --- | --- |
| `file_id` | `string` | Required ID of a single file, not an array. |
| `startIndex` | `int` | gets the starting order of logs. Which log should be returned (optional)  defaults to 0. |
| `pageSize` | `int` | The number of items returned per page (optional) |
| `type` | `int` | Log type (optional)  Default 0, view all records, 1 only view access records, 2 only view uploads and downloads, 3 only view anonymous users, 4 only view sharing and invitations, 5 only view deletion records |
| `userName` | `string` | A username (optional) , returns the log of a certain user |
| `lang` | `string` | language (optional) default cn,  language of returned log cn (Chinese) en (English) |

#### The return information is as follows

```json
{"code":0,"success":true, "logs":[], "total":50}
```

## Call instructions

- Before calling, you need to complete [Get token](https://www.babel.cc/public/babelwiki/en/api-post-api-token-do.html) or the corresponding login-free authentication, and carry `Authorization: Bearer <access_token>` in the request header.
- If there are differences in parameters and return fields due to deployment versions, the actual private cloud API documents and joint debugging results should prevail.
- Category: File API.