# 列出 EDINET 文件

**API:** Data API

**Endpoint:** `GET /v1/beta/edinet/documents.json`

**Tags:** EDINET

列出日本 EDINET 在某一日期的全部申报。date 为必填（YYYY-MM-DD）。type=2 在 results 下返回申报——每条申报包含 docID、filerName、secCode、JCN、docTypeCode、docDescription、submitDateTime、periodStart 和 periodEnd——而 type=1 仅返回元数据，当日数量位于 metadata.resultset.count，且没有 results 数组。约三分之二的申报带有 secCode（上市公司），其余为基金和未上市申报人。申报的 docID 可用于调用 get_edinet_document_download。

### 计费参考

- 计量方式：按成功请求的固定成本计费。
- 参考请求估算：1e-05 美元。

仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `date` | query | yes | string, (date) | 文件日期，格式为 YYYY-MM-DD。 |
| `type` | query | no | integer, enum: 1, 2, default: 1 | 响应模式：1 表示仅元数据，2 表示元数据加申报文件列表。 |

## Responses

### 200 — EDINET 文件列表响应。

Headers:
- `X-Request-Id` (string) — 联系 Felo 支持时需提供的请求标识符。

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "metadata": {
      "type": "object",
      "description": "包含 title、请求参数回显、结果数、processDateTime、status 和 message 的元数据对象。"
    },
    "results": {
      "type": "array",
      "description": "type=2 时的申报文件对象。",
      "items": {
        "type": "object",
        "properties": {
          "seqNumber": {
            "type": "integer"
          },
          "docID": {
            "type": "string"
          },
          "filerName": {
            "type": "string"
          },
          "docTypeCode": {
            "type": "string"
          },
          "submitDateTime": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### 400 — 无法处理该请求。请检查请求参数。

### 401 — 需要有效的 Felo API 密钥。

### 402 — 由于未满足计费要求，请求无法继续。

### 403 — 该账户无权执行此操作。

### 429 — 已达到请求或支出限额。

### 502 — 服务无法完成该请求。

### 503 — API 或计费服务暂时不可用。

### 504 — 服务在处理请求时超时。

### default — 错误响应；上游透传响应可能采用提供方格式

**application/json**

Schema:

```json
{}
```