> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# EDINET 文档列表

> 通过 AIsa 按申报日期查询 EDINET 申报文档。



## OpenAPI

````yaml openapi/zh/edinet.json GET /edinet/documents.json
openapi: 3.1.0
info:
  title: EDINET API
  version: draft-2026-07-28
  description: 用于 EDINET 文档列表和文档下载的 AIsa 网关 endpoint。
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - bearerAuth: []
paths:
  /edinet/documents.json:
    get:
      tags:
        - EDINET
      summary: 列出 EDINET 文档
      description: 按指定文件日期查询 EDINET 申报列表。type=1 时仅返回元数据，type=2 时返回元数据加申报结果。
      operationId: getEdinetDocuments
      parameters:
        - name: date
          in: query
          required: true
          schema:
            type: string
            format: date
            examples:
              - '2026-07-23'
          description: 文件日期，格式为 YYYY-MM-DD。
        - name: type
          in: query
          required: false
          schema:
            type: integer
            enum:
              - 1
              - 2
            default: 1
          description: 响应模式：1 仅返回元数据，2 返回元数据加申报列表。
      responses:
        '200':
          description: EDINET 文档列表响应。
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                    description: 元数据对象，包含标题、请求参数回显、结果数量、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':
          description: 请求参数无效。
        '401':
          description: AIsa API 密钥无效或缺失。
        '429':
          description: 超出速率限制。
        '500':
          description: 网关或上游故障。
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````